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PREFACE 



This manual describes the PDP-8 Real-Time Operating System (RTS/8) . 
Knowledqe of PDP-8 assembly language programming (PAL8) is essential 
for a complete understanding of this manual. In addition, the user 
should be familiar with real-time systems in general and with the 
operation and use of the development system for the PDP-8, OS/8. _lhe 
information in Chapter 9, "Advanced RTS/8 Programming Techniques is 
for the experienced RTS/8 user. It should be read after the user has 
gained familiarity with RTS/8. 

This version of the manual has been enlarged and expanded to 
incorporate several new RTS/8 features. The Major features include 
KL8-A Support, PDP-8/A Null Task, the EXIT Task, and two new 
Executive Requests. Other features are the nonresident implementation 
of the MCR, UDC/ICS support, an 0S8C0M facility that allows the Ob/B 
system to talk to an RTS/8 task, and control files that allow the user 
to efficiently make multiple task copies. RTS/8 flowcharts have been 
added to show system operation. 

The following PDP-8 handbooks will be helpful for review 
reference: 



and 



INTRODUCTION TO PROGRAMMING (DEC-08-XINPA-A-D) 

SMALL COMPUTER HANDBOOK (90P45) 

OS/8 HANDBOOK {DEC-S8-0SHBA-A-D) M^^nAT 

UDC8 UNIVERSAL DIGITAL CONTROL SUBSYSTEM MAINTENANCE MANUAL 

(46H745) 

PDP-8A MINICOMPUTER HANDBOOK {EB0621976) ,„„^.ooomms 

ICS8 INDUSTRIAL CONTROL SUBSYSTEM MAINTENANCE MANUAL {EK0ICS8MM) 
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CHAPTER 1 
INTRODUCTION 



1.1 RTS/8 DESCRIPTION 

RTS/8 is a compact real-time system designed for the PDP-8 family of 
processors (except the PDP-8/S) . This system allows up to 63 tasks to 
run concurrently and compete for resources on a fixed priority basis. 
It can be used for a wide range of applications in which a number of 
processes must be monitored and controlled. As with other real-time 
systems, RTS/8 responds to physical or conceptual events to permit the 
timely execution and. scheduling of tasks. 

The RTS/8 Executive controls execution and interaction among all 

tasks. The Executive decides which tasks should run (based on the 

priorities of the runnable tasks), and services the tasks by means of 
Executive Requests (ERs) . 

A task is the basic program unit within RTS/8. RTS/8 system tasks 
(DEC-supplied) and their file names are listed in Table 1-1. The 
system supports both resident and nonresident tasks. A resident task 
resides permanently in memory; a nonresident task is one in which the 
major portion of the task resides on a mass storage device and is 
loaded into memory only when that task becomes executable. Using 
nonresident tasks permits portions of several tasks to share the same 
areas of memory, providing economical use of memory. 

RTS/8 includes system tasks that control most standard DIGITAL I/O 
devices. A full complement of peripherals is supported, including RK8 
and RK8-E moving-head disks, DF32 and RF08 fixed-head disks, TC08 
DECtape, RX8 floppy disk, LINCtape, DEC cassette, and LE8 and LS8E 
line printers {RTS/8 does not support TD8E DECtape). The Monitor 
Console Routine (MCR) task provides an interface between the user at 
the console terminal and the system. The MCR provides the user with a 
series of commands to control, inspect, and, to some extent, debug the 
system. The MCR commands are straightforward and easy to use. They 
allow the user to schedule and execute tasks at specified intervals, 
suspend task execution, and print system status reports. 

A system task also is provided that allows a single copy of the OS/8 
operating system to run in the background, creating a real-time 
foreground-OS/8 background system. With OS/8 in the background, the 
user has the facilities for program assembly, debugging, and editing. 
The minimum RTS/8 hardware configuration required for a foreground 
only system is a PDP-8 family processor, 4K words of memory, and a 
console terminal capable of paper tape input. A system capable of 
running a real-time foreground and OS/8 in the background requires a 
PDP-8 family processor with KM8-A, KM8-E or TSS-8 Time Sharing 
options, a mass storage device (such as an RK8E cartridge disk or RX8 
floppy disk) , and two terminals (one must be dedicated to OS/8 system 
execution) . 
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RTS/8 tasks are created by editing the RTS/8 master parameter file to 
produce a parameter file that describes the user's particular system. 
Task source files are then assembled with the edited parameter file 
!?^^"L^/o® ^^^^ assembler. The assembler can run either under OS/8, or 
the OS/8 support system under RTS/8. Then using ABSLDR under OS/8, 
all task binaries are joined into a complete RTS/8 system. 



Table 1-1 
RTS/8 System Tasks 



Task Name 



MCR 

null task 

038 

0S8F 

PWRF 

CLOCK 

TTY 

LPT 

DTA 

RK8 

RK8 

RF08/DF32 

CSA 

CSAF 

UDC/ICS 

RX8A 

RX8B 

RX8C 

RX8D 

LTA 

SWAPPER 

NULL8A 

EXIT 



File Name 



Task Function 



PARAM . PA 



RTS8.PA 
MCR. PA 
MCR. PA 
0S8SUP.PA 
0S8SUP.PA 
PWRF . PA 
CLOCK. PA 
TTY. PA 
LPT. PA 
DTA . PA 
RK8.PA 
RK8E.PA 
RF08.PA 

CSA. PA 
CSAF. PA 
UDCICS.PA 

RXOIRT.PA 
RXOIRT.PA 
RXOIRT.PA 
RXOIRT.PA 
LTA . PA 
SWAP. PA 
NULL8A.PA 
EXIT. PA 



System parameter file with 

equates blank. Appropriate 

values should be inserted to 

create specific parameter files. 

RTS/8 Executive 

Monitor Console Routine 

Null task 

OS/8 Support Task 

OS/8 File Support Task 

Power Fail Task 

Clock Handler Task 

Terminal Driver Task 

Line Printer Driver Task 

TC08 DECtape Driver Task 

RK8 Disk Driver Task 

RK8E Disk Driver Task 

RF08/DF32 Fixed-Head Disk Driver 

Task 

Cassette Driver Task 

Cassette File Support Task 

Universal Digital Controller/Industrial 

Controller Subsystem Handler Task 

Floppy Disk Handler (1st controller) 

Floppy Disk Handler (2nd controller) 

Floppy Disk Handler (3rd controller) 

Floppy Disk Handler (4th controller) 

LINCtape Driver Task 

Nonresident Task swapper 

Null Task for PDP-8A 

Exit Task 



1.2 REAL-TIME SYSTEM OPERATION 

A multiprogramming system is a software framework that allows 
available resources (such as memory, CPU time, and peripheral devices) 
to be shared by several tasks. Basically, a task is a portion of 
machine code that performs a specific function; a task is defined by 
convention since it overlaps with the definitions of "proqram" and 
"subroutine." 

Multiprogramming allows many tasks to be in some state of execution 
simultaneously. If a task cannot use available central processor time 
because it is waiting for completion of an I/O operation (or is 
blocked by some other condition), the central processor can be 
switched to another task to use the available time, thus increasinq 
system efficiency. ^ 
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Most real-time systems are required to serve a group of tasks that run 
at varying times or frequencies and alternate between being compute 
bound or I/O bound. If machine resources are to be efficiently used, 
these tasks cannot be run in series since the central processor will 
be poorly utilized during the periods the tasks are I/O bound. In 
addition, most real-time tasks are essentially time-critical and 
should not wait for a slow, less important I/O or compute bound task 
to finish before being executed. Thus, multiprogramming and a 
priority scheme for scheduling the central processor provide maximum 
resource utilization. 

Thus, a real-time system is a multiprogramming system that must, in 
addition to the multiprogramming features, respond quickly to critical 
internal or external events. The real-time system is required to 
suspend the operation of a less important task and start the task that 
deals with the critical event. 

A priority scheme establishes the relative importance of various tasks 
in the system. This allows a less important task to be interrupted to 
permit execution of a critical real-time task. For RTS/8, a fixed 
priority scheme was chosen because such a scheme is simple and 
reliable, and requires low scheduling overhead. 
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CHAPTER 2 
USING TASKS UNDER RTS/8 



2.1 THE STRUCTURE OF RTS/8 TASKS 

The RTS/8 Executive is the controlling program in an RTS/8 System. 
The Executive decides which task should run based on the priorities of 
the runnable tasks (those tasks not waiting for completion of any I/O 
or other events) . It also provides services to the tasks by means of 
Executive Requests. Executive Requests are discussed in Chapter 3. 

The user assigns unique task numbers to each task in an RTS/8 System. 
He can assign up to 63 (77 octal) task numbers, and must account for 
system tasks within the total number of tasks. A task number, once 
assigned, cannot change during the execution of the program, since 
RTS/8 uses a fixed priority system. Task numbers serve the following 
purposes: 

1. The task number is used by the RTS/8 Executive as an index to 
various system tables which contain information about each 
task. 

2. The task number is used by other tasks in the system to 
reference a particular task when performing certain Executive 
Requests (such as sending a message) . 

3. The task number determines the task's priority - the lower 
the task number, the higher the priority of the task. 

The Executive uses five internal tables to maintain information about 
the tasks in the system. A brief description of these tables is given 
in Section 2.3. 



2.2 CONCEPTS OF TASK COMMUNICATION 

RTS/8 is event driven, i.e., the highest priority runnable task 
executes continuously until it is completed or some event or condition 
in the system causes it to be suspended. Another change or condition 
can reactivate the task. Tasks can be self-starting if assembled to 
run at system startup, started by another task, or started by the user 
at the terminal console using the MCR task. RTS/8 performs two main 
types of task communication, as follows: 

1. Task synchronization through the use of Event Flags 

2. Intertask messages 
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2.2.1 



Task Synchronization Through the Use of Event Flags 



Whenever two processes occur independently, one process may need to 
wait until the execution of the other is finished. This can be 
Illustrated by using the PDP-8 terminal interface as an example. The 
PDP-8, when ready to generate the first character, alerts the terminal 
by issuing a Load Teleprinter Sequence (TLS) instruction. The PDP-8 
must now wait in a TSF; JMP.-l loop if it wishes to do further I/O 
immediately. It cannot proceed with the next character until the 
terminal raises its ready flag to signal that it is finished printing 
the first character. When the flag is raised, the PDP-8 then exits 
from the wait loop and proceeds to load the next character. 

Similarly, RTS/8 provides Event Flags as a signalling mechanism to 
synchronize tasks with each other. An Event Flag is a user-chosen 
location that contains the status of an event. The events are either 

1) physical processes such as a clock ticking or a valve closing, or 

2) conceptual occurrences such as a certain string of characters typed 
by the operator or scheduling a task for execution. Like device 
flags, an Event Flag can signify either a busy or a completed state, 
defined as PENDING (>0) and FINISHED (=0), respectively. Thus, a task 
can direct another task via a message to perform a specified action, 
at which time it sets a mutually-agreed upon Event Flag to the PENDING 
value. When the second task has completed the specified action it 
sets the Event Flag to the FINISHED value; this is known as Posting 
the Event Flag. As a simple example, if the first task has been 
waiting for the Event Flag with the instructions: 

TAD Event Flag /LOAD EVENT FLAG IN AC 
SZA CLA /IF EVENT FINISHED, SKIP 

JMP .-2 /KEEP TRYING 

then the Posting of the Event Flag will cause the first task to exit 
from Its loop, continuing on with the knowledge that the second task 
has completed its processing. 

Since this loop ties up the PDP-8 processor, Event Flags under RTS/8 
have an additional state, WAITING (<0) . Using the example just cited, 
the addition of the WAITING state now allows the first task to tell 
the RTS/8 Executive that it wants to WAIT until the Event Flag 
signifying the status of the second task is FINISHED. The monitor 
saves the contents of the waiting task's PC and sets the Event Flag 
Wait bit m its Task Flags Table Word. The Event Flag is set to the 
WAITING state. The WAITING state for an Event Flag is octal 4000 plus 
the waiting task's Task Number. When the Event Flag is POSTed via an 
RTS/8 Executive Request call, the task WAITING for it is automatically 
taken out of Event Flag Wait by RTS/8. (If no other blocking bits are 
set, the waiting task is again runnable, and will resume execution 
when higher priority tasks are blocked.) WAITE is the mnemonic for the 
RTS/8 Executive Request that Waits for an Event Flag. 

This code would look as follows: 

CAL 
WAITE 
event flag 

All Executive Requests are described fully in Chapter 3. A summary of 
Event Flag states is shown in Table 2-1. 
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Table 2-1 
Summary of Event Flag States 



Event Flag State 



FINISHED (posted) 

PENDING 

WAITING 




>0 



Value 



<0 (4000 + Task No.) 



2.2.2 Intertask Messages 

Just as Event Flags under RTS/8 are analogous to hardware device 
flags, messages are analogous to data-sending hardware I/O 
instructions (for example, TLS) . That is, messages start a task, 
oroviding the task is WAITING for a message, and at the same time, 
they pass information to the task. Messages are transmitted by 
Executive Requests. 



An RTS/8 message consis 
any number of contiguo 
two tasks. The Message 
first word of the Me 
When the message is sen 
the PENDING state. Th 
not yet completed. No 
the message by the re 
receiver POSTs the Eve 
specified (or implied 
purposes : 



ts of a thre 
us words of 

Header is 
ssage Header 
t, the RTS/8 
is signifies 
action occur 
ceiving task 
nt Flag wh 
) by the 



e-word Message Header followed by 

information to be exchanged between 

used exclusively by RTS/8. The 

is the Event Flag for the message. 

Executive sets the Event Flag to 

that the message has been sent but 

s to the Event Flag upon receipt of 

however, RTS/8 requires that the 

en it has performed the action 

message. This posting serves two 



1. It informs the task which sent the message (the "sender") 
that the requested action has been completed, and 

2. It allows the message to be sent again (see Item 2 below) . 



If multiple messages are waiting to 
the second and third words of 
messages together (see Figure 2-1) . 
Data Field) instruction to the fi 
word is the address of the next mes 
that this is the last message. If 
waiting for a message, the message 
Input Message Queue. Messages are 
priority of the sender (increasing 
the same task are queued in the ord 



be received 

the Messag 

The second 

eld of the n 

sage. A sec 

the receivi 
is placed on 

then queued 
task number) 
er in which 



by a task, RTS/8 uses 
e Header to link these 

word is a CDF (Change 
ext message. The third 
ond word of signifies 
ng task is not actively 

the receiving task's 

in order of decreasing 
Messages sent from 
they were issued. 
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RTS/8 EXECUTIVE 
MSGTBL 



MESSAGE 1 



MESSAGE 2 



CDF 



PTR 




MESSAGE 3 



Event Flag 



CDF 



PTR 




Event Flag 



CDF 



PTR 




Event Flag 



Message 
Header 



Message 
Content 



Figure 2-1 Message Format and Linking of Messages 

^^^n,I=== °^ ^"^ message can contain any desired information. Sending 
a message does not physically move the message information to the 
receiving task, but provides the receiver with the field and address 
of the first data word of the message. aaaress 

It should be noted that the information in a message is not copied 
into the receiver's area. This has the following implications: 



Data in a message should not be modified by the sender 
the Event Flag for the message is PENDING. 



while 



The same message cannot be sent a second time before its 
Event Flag is FINISHED the first time. RTS/8 enforces this 
by checking the message Event Flag on a SEND operation and 

stiirPEND^NG.^^"'^" '"^'^ ^''^"*' ^^^^ ^^'^ '^ ^^^ message is 

It ^\^!^^"^ 5°"^ ^^^ receiving task to store information in 
tne body of the message. In this way, an "answer" to the 
message can be returned without the complications of sending 
a return message back to the sender. For example, when a 
task sends a message to the disk driver task requesting I/O, 
the driver places the error status of the completed operation 
m a specific word in the message to indicate whether an 
error occurred. 
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2.3 EXECUTIVE INTERNAL TASK TABLES 

The Executive uses five internal tables to maintain information about 
the tasks in the system. A brief description of these tables is as 
follows: 



Table 
Task State Table (TSTABL) 

Task Flags Table (TFTABL) 



Task Input Message Queue 
Header Table (MSGTBL) 



Residency Table (RESTBL) 



Partition Table (PARTBL) 



Description 

Contains information such as the 
contents of the task's PC, Link and AC 
at the time the task stopped running. 

Contains information about why the task 
is not running, i.e., it indicates for 
what conditions (blocking or wait bits) 
the task is waiting. 

Contains messages that have been sent 
to this task. This table is referred to 
simply as the Message Table. 

Used for nonresident tasks, this table 
specifies where the task is to reside in 
memory, and where it resides on the swap 
device . 

Used for nonresident tasks, this table 
contains information about each memory 
partition, such as length and location 
of the partition. Memory partitions are 
shared by nonresident tasks. 



The user does not need to know the format of these tables to use 
RTS/8. However, a detailed explanation of these tables is given in 
Appendix E. 
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CHAPTER 3 
RTS/8 EXECUTIVE REQUESTS 

3.1 COMMUNICATION WITH THE RTS/8 EXECUTIVE 

RTS/8 tasks communicate with the RTS/8 Executive via Executive 
Requests (ERs) . RTS/8 uses locations 20-27 in every field as a 
communication region for ERs to facilitate Executive Requests across 
field boundaries. The Executive can be called in any field via a JMS 
20 instruction (designated symbolically as CAL) . The Data Field (DF) 
does not have to be any specific value when the CAL is given, since 
the code in location 20 sets the DF to the Instruction Field (IF), 
sets the IF to and jumps to the RTS/8 Executive. 

A summary of Executive Requests is given in Table 3-1. Most of the 
Executive Requests are explained in detail in this chapter. The 
RESCHD, WAITX and DERAIL Executive Requests are described in Chapter 
9. 

The RTS/8 Executive will not honor any request to switch tasks arising 
from an interrupt if the interrupted task's Program Counter (PC) was 
less than lOO(octal). This protects the RTS/8 Executive's entry point 
(location 20 in each field) from being destroyed. User tasks must be 
written so that instructions are never executed below 100 in any 
field. 

All ER's except DERAIL and SKPINS can relinquish processor control to 
higher-priority tasks as a result of their action. 



3.2 ERs USED TO COMMUNICATE BETWEEN TASKS 

The five ERs associated with the Intertask Messages and the Event 
Flags are SEND, WAITE, SENDW, RECEIVE and POST. An example of their 
use is shown in Section 3.2.6. In addition, a sixth ER called WAITX 
is described in Chapter 9, Advanced Programming Techniques (Section 
9.2.2) . 
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Table 3-1 
Summary of Executive Requests 



Code 



10 

11 

12 

13 
14 



Symbolic 
Name 



SEND 
RECEIVE 

WAITE 

RUN 

SUSPND 
POST 
SKPINS 

DERAIL 

BLKARG 

SENDW 

UNBARG 

RESCHD 
WAITX 



Description 



Send a message to a task 

Look for and/or receive a 
message from a task 

Wait for an Event Flag to be 
posted 

Run a task 

Suspend execution of a task 

Post an Event Flag 

Insert code into interrupt 
skip chain 

Derail or force a task's 
execution to a new address 

Block a task from running for 
a specific reason 

Send a message and wait for 
it to be received 

Remove a reason that a task 
is blocked from running 

Force the RTS/8 Scheduler to run 

Wait for a particular Event 
Flag to be posted 



Section Reference 



3.2.1 
3.2.4 

3.2.2 

3.3.4 
3.3.3 
3.2.5 
3.4 

9.2.3 

3.3.1 

3.2.3 

3.3.2 

9.1.2 
9.2.2 



3.2.1 SEND - Send Message 

Format: CAL 
SEND 
TSKNUM 
MESSAG 



The SEND ER 
CAL instruc 
task has a h 
message, th 
In this case 
message is 
PENDING (non 
SEND, the s 
and only whe 
performed 
task as only 
the first ta 



sends the message located 
tion to the task whose num 
igher priority than the 
e sender is temporarily 
, the sender is not put i 
sent. However, if the 
zero) , meaning the message 
ender will be put into Eve 
n the Event Flag becomes F 
Care should be taken that 
the last request to send 
sk can go to sleep in Even 



at MESSAG in the field of the 
ber is TSKNUM. If the receiving 
sender and is waiting for a 
suspended and the receiver runs, 
nto any WAIT state once the 
Event Flag in location MESSAG is 

is still busy from a previous 
nt Flag Wait on location MESSAG, 
INISHED (zero) will this SEND be 

a message is sent from only one 
a busy message is remembered; 
t Wait permanently. 



3-2 



RTS/8 EXECUTIVE REQUESTS 



3.2,2 WAITE - Wait on Event Flag 



Format! 



CAL 

WAITE 

EFLG 



The WAITE ER checks the status of location EFLG and if it is FINISHED, 
returns control to the caller. If EFLG is PENDING, its state is 
chanqed to WAITING and the calling task is put into Event Flag Wait. 
When' location EFLG is POSTed by another task or interrupt routine, the 
calling task becomes runnable again. The Event Flag must be 
initialized (set to 1) before use in most cases, particularly when a 
task is initiating an event to be completed by another task. The 
waiting task must reset the Event Flag before using it again m that 
the Event Flag does not reset itself. 



NOTE 

In advanced applications, the user may 
be waiting for multiple Event Flags (see 
Section 9.2.1 for description of WAITM) . 
In this case the task will run whenever 
any one of the Event Flags is posted, 
and not necessarily the one specified in 
the WAITE. To insure that a particular 
Event Flag is posted, use the WAITX ER 
described in Section 9.2.2. 



3.2.3 SENDW - Send and Wait 

Format: CAL 

SENDW 

TSKNUM 

MESSAG 

The SENDW ER is exactly equivalent to the sequence: 

CAL 

SEND /SEND THE MESSAGE 

TSKNUM 

MESSAG 

CAL 

WAITE /WAIT FOR RECEIVER TO ACKNOWLEDGE 

MESSAG 



3.2.4 RECEIVE - Receive Message 
Format: 



MADDR, 



TAD TSKNUM 
CAL 

RECEIVE 




/ONLY TO RESTRICT TO ONE 
/SENDING TASK 

/MESSAGE ADDRESS STORED 
/HERE; CDF TO MESSAGE 
/FIELD IN AC ON RETURN 



If the AC is zero when the RECEIVE ER is issued, the calling task's 
Input Message Queue is examined. If there are messages in the calling 
task's Input Message Queue, the first (i.e., highest-priority) message 
is dequeued and the address of its first data word is placed in MADDR. 
A CDF to the field of the message is stored in the AC. 



3-3 



RTS/8 EXECUTIVE REQUESTS 

If there are no messages, the task is placed in Message Wait until 
such time as a message is sent to this task. However a task mav 
first examine Its Input Message Queue Header in fielSo to determine 
the state of the Input Message Queue. aecermme 

If the AC is nonzero when the RECEIVE ER is issued, the callina task'.. 
SL ^fT^.^*"^"^ ^" searched for a message wESL sendee's ?ask 
Ts foun6 it ?' ^°"tents of bits 1-11 of the Ic. If such a mLsage 
is found, It is removed from the queue as specified above- if a 
message is not found, the issuing task is placed in Messaae' w^if 
This allows a message from only one given task to be deceived! 



NOTE 

The following information is useful to 
the advanced user. When a task is in 
MSGWT, after just having done a RECEIVE, 
its PC as stored in the TSTABL points 
back to the location containing the CAL. 
Thus, when a message comes in, the task 
re-executes the RECEIVE ER and accepts 
the message. This mechanism is normally 
transparent to the user. One 
implication is that no harm is caused by 
taking a task out of MSGWT because once 
the task starts up again, it will 
re-execute the RECEIVE ER, and go back 
into MSGWT. 



a 



Normally, if there are no messages in the Input Message Queue when a 
task performs a RECEIVE, the task is put into Message Wait Howl^er! 
a 1 in bit of the AC (i.e., the AC is negative) when the RECE?vr Is 
issued indicates that the task is not willing to wait. Thus, with no 
messages in the Input Message Queue (or none sent by thr task 

at"lL''3)'eit;'the'lr °' '^/'^' '"^ '^'^ ""'' ^•^^^ continue to ?un 
for the RTS/8 Exeunt H ^^^^^ to zero. The zero AC provides the means 

(o°f III '"'{red'^typer^endiJgf"'^'" ''^ '''' ^'^^ '"^^'^ ^^ - — ^- 



3.2.5 POST - Post Event Flag 

^°'^™^t: TAD EFPTR /POINTER TO EVENT FLAG 

POST 

CDF EFFLD /FIELD OF EVENT FLAG 

The Event Flag pointed to by the AC, in the field specified by the 

WAITING the task'JLr''''"'°-i'"'^n '^^^' ' '' '^^ P^^^^^^^ ^^ate was 

Salt TMo pp ^^ was waiting for it is cleared of its Event Flag 

^ttl' -J /^ u^''^^ ^^^^ ^^^ calling task in a WAIT state. If the 

task waiting for the Event Flag is of a higher priority than the 

oJJer'^is run'' " ''"'"^ '""' '' temporlrily suspended ^hlle tSe 
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3.2.6 Example of ERs for Message and Event Flags 

The following example illustrates the RTS/8 ERs dealing with Messages 
and Event Flags. Since I/O and interrupts under RTS/B have not been 
discussed yet, this example is elementary. There is no advantage to 
keeping the functions of the two tasks separate, and the entire 
send/receive structure is being used here as an elaborate subroutine 
call. A description of the execution sequence follows the example. 

Task A 



Al 



A2 



A3 



A4 



ALOOP, 



MESl, 



CAL 

SEND 

B 

MESl 

CAL 

SEND 

B 

MES2 

CAL 

WAITE 

MESl 

JMP ALOOP 

ZBLOCK 3 

15 

37 

23 



/SEND TASK B MESSAGE 1 



/SEND TASK B MESSAGE 2 



/WAIT FOR MESSAGE 1 

/LOOP 
/MESSAGE 1 
/RANDOM NUMBERS 



MES2, 



ZBLOCK 3 
-1 

4 



/MESSAGE 2 
/RANDOM NUMBERS 



Task B 



Bl 



B2 
B3 
B4 
B5 
B6 

B7 
B8 
B9 



BIO 



Bll 



BLOOP, 
MADDR, 



EFCDF, 



CAL 

RECEIVE 



DCA EFCDF 

TAD EFCDF 

DCA .+1 

HLT 

TAD I MADDR 

CLA 

STA CLL RTL 

TAD MADDR 

CAL 

POST 

HLT 

JMP BLOOP 



/GET A MESSAGE 

/SAVE MESSAGE CDF FOR POST 

/PUT CDF INLINE 

/CDF TO MESSAGE FIELD 

/GET 1ST DATA WORD OF 

/MESSAGE (DO NOTHING WITH IT) 

/-3 IN AC 

/AC POINTS TO MESSAGE 

/EVENT FLAG 

/DECLARE MESSAGE RECEIVED 
/CDF TO MESSAGE FIELD HERE 
/LOOP 



The flow of execution in this example depends on which of the two 

tasks has higher priority. Assuming that at some time both A and B 

become runnable and task A has higher priority, the sequence of 
execution is as follows: 



Sequence 

Al 
A2 
A3 

Bl 



Reason For Execution 

Task A has higher priority than task B. 
Task A has higher priority than task B. 
Task A has higher priority than task B. 
Task A is now in Event Flag Wait since 



MESl 



was PENDING; MESl is now in WAITING state. 
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^^"^uence Reason For Execution 

^2~^^° Task A is still waiting; the RECEIVE at Bl 

received MESl 
^^ The POST at BIO posted MESl and "woke up" A, 

which has higher priority than B. 
^1 A continues executing. 

*2 A tries to send MES2 again; B has not yet 

processed it; MES2 is PENDING. 
^^^ Therefore, A is put into Event Flag Wait and 

B IS resumed; MES2 is now WAITING. 
Bl-BlO B now RECEIVes and POSTs MES2. 
^2 This brings A out of Event Flag Wait; the 

RTS/8 Executive has modified task A's program 

counter so that it will re-execute the 

offending SEND. 
^3 A3 now waits for MESl to be POSTed . 

If task B has higher priority, the sequence of execution is: 

Sequence Reason For Execution 

Bl Task B has higher priority than task A. 

^^ Task B is placed in Message Wait since there 

are no messages in its input queue. Task A 

then sends MESl to Task B. 
B^~B^° Task A's message brings task B out of Message 

Wait; since B has higher priority, A is 

stopped and B runs. 
^^^ The POST at BIO sets MESl to FINISHED but has 

no other effect. 
Bl Now task B tries to get another message. 

^^ There are no other messages, so task B is put 

in Message Wait and A is run. 
B2-B11 Task A sends MES2 which "wakes up" B- B 

processes MES2 and 
Bl returns for more, 

^3 and is put in Message Wait. Since MESl is 

FINISHED 
^4 the WAITE at A3 has no effect and task A 

*1 loops back to Al and sends MESl again. 



3.3 ERs USED TO SET AND CLEAR TASK FLAGS 

P^In^^^fm ^^^°r ^ ^r" to^'^Plicitly set and clear flags in the Task 
Flags Table entry of another task, and to set flags in its own table 
entry. These ERs are BLKARG, UNBARG, SUSPND and RUN. 



3.3.1 BLKARG - Block Task for Specified Reason 

Format: TAD TASKNUM /OR IF SELF 
CAL 

BLKARG 
WAITBITS 

TASKNUM contains the number of the task to be blocked (that is, not 
allowed to run). WAITBITS specifies one or more bits to be set in 
that task s Task Flags word. Assuming WAITBITS is nonzero, this will 
cause the specified task to become non-runnable . If TASKNUM contains 
zero, the issuing task will be blocked on the specified wait bits. 
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The TASKNUM=0 form of this ER is the only legal way to specify the 
issuing task as the task to be blocked; if TASKNUM is equal to the 
issuing task number, the action of this ER is undefined. 

Example : 

Task 14 is placed into User Wait by executing the following code. 



TAD 
CAL 

BLKARG 
USERWT 



(14 



Symbolic names for specifying the condition for blocking or unblocking 
a task in the WAITBITS word is given in Table 3-2. 



Table 3-2 
Symbolic Names for Specifying WAITBITS 



Symbolic Name 



NONRWT 



EFWT 



RUNWT 



SWPWT 



EORMWT 



USERWT 



ENABWT 



MSGWT 



DNEWT 



Value 



4000 
2000 

1000 

0400 
0200 

0100 

0040 

0020 
0001 



Meaning 



Nonresident Wait - This task 
because it is not in memory. 



cannot run 



Event Flag Wait - This task is waiting for an 
Event Flag (which contains a WAITING value 
corresponding to this task) to be POSTed . 

Run Wait - This task is waiting for a RUN ER 
to be executed with its number in the AC, or 
for the operator to type "REQUEST task" to the 
Monitor Console Routine (see Chapter 5) . 

Swap Wait - This task cannot run because it is 
in the process of being brought into memory. 

Event or Message Wait - This task is waiting 
for an Event Flag to be posted or a message to 
arrive, whichever happens first. 

User Wait - This bit is reserved for use by 
user-written tasks. RTS/8 does not use this 
bit. 

Enable Wait - This task is waiting to be 
Enabled. Use of this bit is restricted to the 
Monitor Console Routine for the "ENABLE task" 
and "DISABLE task" commands (see Chapter 5) . 

Message Wait - This task is waiting to be sent 
a message. 

Task does not exist. This bit should never be 
set or cleared by a user task. 
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3.3.2 UNBARG - Unblock Task for Specified Reason 

Format: TAD TASKNUM 
CAL 

UNBARG 
WAITBITS 

TASKNUM contains the number of the task to unblock, and WAITBITS 
specifies one or more bits to be cleared in that task's Task Flaqs 
word If the Task Flags word becomes zero as a result of thi! 
operation, the specified task becomes runnable; if the specified task 
has higher priority than the issuing task and becomes runnable, the 
issuing task is temporarily suspended while the higher-priority task 

This ER is a no-op (no operation) if issued with TASKNUM equal to the 
issuing task's number. "^h^^j. to zne 

Example: 

Task 14 is taken out of User Wait by executing the following code. 

TAD (14 
CAL 

UNBARG 
USERWT 



3.3.3 SUSPND - Suspend a Task's Execution 

Format: TAD TASKNUM /O IF SELF 
CAL 
SUSPND 

This SUSPND ER is identical in action to the following instructions 

TAD TASKNUM 
CAL 

BLKARG 
RUNWT 



3.3.4 RUN - Run a Task 

Format: TAD TASKNUM 
CAL 
RUN 

This RUN ER is identical in action to the following instructions: 

TAD TASKNUM 
CAL 

UNBARG 
RUNWT 

The SUSPND and RUN ERs exist because their function is performed often 
enough to warrant a shorthand version. An example that shows how thev 
can be used in a task follows. 

A data collection task is to print a report every 1000 data points 
without interrupting the data collection/reduction process. When 
executed, the Report Generation Task comes up running, so that the 
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first report occurs on the first data. In this simplified example, 
the data operated on by the report program may have been already 
updated for the next cycle before being reported. A full example 
would require a scheme such as double buffering to protect the data. 



Data Control Task 



DLOOP, 
DATALP, 



COUNT, 



RLOOP, 



TAD (-1750 
DCA COUNT 
CAL 
WAITE 
DATAEF 



ISZ COUNT 

JMP DATALP 

TAD (REPORT 

CAL 

RUN 

JMP DLOOP 





/lOOO DECIMAL 



/WAIT FOR DATA READY 
/CODE TO STORE DATA 
/POINT IN BUFFER 

/GET A DATA POINT 
/AND PROCESS IT 
/COUNT OFF 1000 POINTS 

/RUN REPORT TASK 

/KEEP COLLECTING 



Report Generation Task 



CAL 
SUSPND 
JMS TITLE 



JMP RLOOP 



/AC=0, SUSPEND 
/UNTIL NEEDED 
/HAS BEEN RUN 

/PRINT REPORT 
/WITH TITLE 



/REPORT OVER-GO 
/BACK AND WAIT 



To eliminate interference with the data collection, REPORT should have 
a lower priority than DATA. 



3.4 USING INTERRUPTS IN RTS/8 

The RTS/8 Executive contains code to receive and dismiss hardware 
interrupts and to perform inter rupt-initiated task switching, but it 
does not provide room for an interrupt skip chain. Instead, the skip 
chain is literally a chain and is built up dynamically at system 
startup time via the SKPINS ER. A description of the SKPINS ER is as 
follows. 



Format: 



CAL 

SKPINS 

MODULE 



MODULE is the address (in the current field) of an interrupt 
processing module. 
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An interrupt processing module has the following format: 

MODULE, /THIS WORD GETS A POINTER 

/TO THE NEXT MODULE 
/MODULE ENTERED HERE - CONTAINS 

/CDF GIF TO NEXT MODULE FIELD 
SKDR /SKIP ON DEVICE READY 

(S^P) /(ONLY IF SKDR REALLY MEANS SKIP 

/ON DEVICE NOT READY) 
JMP I MODULE /NOT READY - GO TO NEXT MODULE IN 

/CHAIN 
CDF GIF CUR /THIS ONE IS MINE - SET DF AND IF 

/CORRECTLY 

/INTERRUPT PROCESSING 

CIP /DISMISS THE INTERRUPT, MAYBE POST 

POSTDS /AN EVENT FLAG DEPENDING UPON 

/CONTENTS OF AC 

See item 7 below for the definition of the POSTDS instruction. 

Whenever a task executes a SKPINS ER, the interrupt chain is broken at 
the very end and the user's interrupt module is inserted. This is 
usually done by tasks at system start-up time only. The last 
interrupt module points to the interrupt dismiss routine as its "next 

c^oTMc \ ^" ^^^^ ''^^' ^^^/^ ^^^^^ ^° ^^^i-^ superfluous interrupts. 
SKPINS always inserts at the end of the skip chain. This implies that 
the skips in the skip chain are ordered roughly by priority of the 
task which inserted them, since any SKPINS ERs in a task are usually 
executed as once-only code at system start-up time. 

Once an interrupt module receives control (i.e., its I/O skin 
succeeds), there are several restrictions on its execution: 

1. The interrupt module must clear the interrupt request. 

2. The Data Field and Instruction Field are those of the next 
interrupt module; the user must correct this as described 
above before any indirect addressing or jumps are performed. 

3. An interrupt module may not issue any RTS/8 ERs. 

4. An interrupt module should not compute excessively when 
interrupts are off. Typical execution time should be under 
75us. If considerably more computing than this is needed, a 
task should be scheduled to perform it by POSTing an Event 
Flag. A POSTDS instruction is used to wake up the task from 
Event Wait. 

5. Interrupt modules must not turn interrupts on because the 
state of the interrupted task will be destroyed by a second 
interrupt. 

6. On entry to the interrupt module, the contents of the AC, 
Link, and Data Field have already been saved, but not the 
contents of the Multiplier Quotient (MQ) . Therefore, 
interrupt modules requiring the use of the MQ should save it, 
and then restore it before dismissing the interrupt. 

7. Interrupt modules must dismiss the interrupt by setting the 
Instruction Field to and issuing a POSTDS instruction. 
POSTDS IS defined as a JMP I 24 instruction. An Event Flag 
may be POSTed when the interrupt is dismissed by setting the 
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Data Field to the field of the Event Flag and placing the 
location of the Event Flag in the AC prior to issuing the 
POSTDS. For example: 



CDF CUR 
TAD (EVFLG 
CIF 
POSTDS 



/DF = THIS FIELD 

/EVFLG MAY NOT BE AT LOCATION 

/DISMISS INTERRUPT AND POST EVFLG 



If an Event Flag is not going to be posted by the interrupt 
routine, the AC must be cleared prior to issuing the POSTDS 
instruction. 

For example, an RTS/8 Paper Tape Punch handler task might contain the 
following sections of code: 

In the initialization code (contained in a task that is runnable at 
system start-up time) : 



START, CAL 

SKPINS 
PTPINT 

GETREQ, CAL 

RECEIVE 



/LINK THE PUNCH SKIP 
/INTO THE SKIP CHAIN 



/WAIT FOR MESSAGE 



As a character punch subroutine used by the main body of the task: 



PUNCH, 



DCA TEMP 
CAL 
WAITE 
PTPEF 

ISZ PTPEF 

TAD TEMP 

PLS 

CLA 

JMP I PUNCH 



/ENTER WITH CHAR IN AC 

/SAVE CHAR 

/WAIT UNTIL PUNCH READY 



/SET PUNCH EVENT FLAG 
/TO THE PENDING STATE 



/PUNCH CHAR 
/RETURN 



Interrupt skip chain code: 

PTPINT, ZBLOCK 2 
PSF 

JMP I PTPINT 
CDF CIF CUR 
PCF 

TAD (PTPEF 
POSTDS 



/USED TO CHAIN SKIPS 
/CHECK PUNCH FLAG 
/NOT READY 
/SET CORRECT DF , IF 
/CLEAR PUNCH FLAG 

/DISMISS INTERRUPT, 
/POSTING PTPEF 



PTPEF, 
TEMP, 



/PUNCH INITIALLY READY 



RTS/8 does not provide a mechanism for removal of entries from the 
interrupt skip chain. 
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3.5 EXECUTIVE REQUEST WAIT STATES 

A summary of wait states generated by Executive Requests is shown in 



Table 3-3. 



Table 3-3 
Summary of Wait States Incurred by Executive Requests 



ER 



SEND 



RECEIVE 
(No wait 
if AC=4000) 

WAITE 

(No wait if 

EF 'done') 

RUN 

SUSPND 

POST 

SKPINS 

DERAIL 

BLKARG 

SENDW 



UNBARG 
RESCHD 
WAITX 

WAITM 



Wait State 



none 

MSGWT 

EFWT 

none 

RUNWT 

none 

none 

none 

any (given by 
argument) 

EFWT 

EFWT 
none 
none 
EORMWT 



any (given by 
argument) 



Condition 



EFWT for SEND if 
message busy at 
'CAL' 

If no messages 
in Input Queue 
and AC positive 

If Event Flag 
not FINISHED 



If task = self 



If task = self 



If message free 
but Event Flag 
not FINISHED 
If message busy 



If specified Event 
Flag not FINISHED 



PC Suspended 
At 



'CAL 



•CAL'+3 



'CAL '+2 



'CAL '+3 

'CAL '+3 
1 r'A T I 



'CAL' 



'CAL' 



'CAL '+3 



NOTE: (a) 'CAL' denotes the address of the CAL instruction in the 
Executive Request. 

(b) A message is said to be busy if its Event Flag has not yet 
been POSTED by its previous user. 
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CHAPTER 4 
RTS/8 SYSTEM TASKS 



The RTS/8 system includes system tasks that control most of the 
standard Digital PDP-8 I/O devices. Also included is one task that 
provides interactive system control from the console terminal and 
allows a single copy of the OS/8 monitor system to run in the 
background. Foreground tasks are protected from background tasks; 
however, the reverse is not true. The complete list of system tasks 
available in the RTS/8 system is as follows: 

• Clock Handler - accepts requests in the form of RTS/8 
messages to perform actions after a specified time has 
elapsed . 

• Console and Non-console Terminal Handlers - handle a single 
terminal in either line or character mode. 

• Line Printer Handler - supports an LS8, LS8E, LP8 or LV8 line 
printer . 

• Mass Storage Handlers - Control the passing of information 
from these devices to and from memory for the RK08 and RK8-E 
moving-head disks, DF32 and RF08 fixed-head disks, and TC08 
DECtape unit. Data is read and written in the standard RTS/8 
block format (400 octal contiguous words). 

• Floppy Disk Handler - provides support for the use of the RX8 
floppy disk. 

• LINCtape Handler - supports both OS/8 and DIAL-format 
LINCtapes. 

• OS/8 Files Support Task - allows the user to look up, create, 
and delete files in OS/8 directories from a foreground task. 
This task, when used with the mass storage handlers, provides 
the capability to read or write OS/8 files on mass storage 
devices. 

• OS/8 Support Task - supports the execution of an OS/8 
operating system in the background. 

• UDC/ICS Handler - enables the user to control the various 
types of UDC/ICS modules. 

• Cassette Handler - allows the user to read or write data on a 
tape cassette. 

• Cassette File Support Handler - allows the user to look up, 
enter, and delete files from a DECcassette in CAPS-8 format. 
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t Power Fail Task - when used with powQr fail hardware, it 

provides for an orderly shutdown when AC power is lost. 
Also, it allows a programmed restart when power returns. 

• Exit Task - allows the user to perform special processing 
before making an exit from RTS/8. 

• PDP-8A Null Task - allows the user to count in decimal on the 
LED display of the PDP-8A. 

The sources of the system tasks are supplied with the RTS/8 system. 
The tasks referred to as "handlers" are completely message-driven, 
i.e., when idle they are in the Message Wait state. Other tasks send 
these handlers I/O request messages. When the handler completes the 
I/O operation, it POSTs the Event Flag associated with the request 
message and issues another RECEIVE ER. 



4.1 CLOCK HANDLER 

The Clock Handler Task can be assembled to handle any one of four 
hardware clocks. The user selects the clocks by setting the symbol 
CLKTYP in the parameter file to for KD8-EA/DK8-EC, to 1 for KW12, to 
2 for PDP-8A, or to 3 for DK8-EP. The Clock Handler accepts RTS/8 
messages and inserts the entries into an internal clock queue. As the 
entries become due, they are removed from the queue, and the request 
is decoded and executed. The user fixes the length of the queue at 
assembly time by defining the symbol CLKQLN in the parameter file to 
the minimum number of entry slots. The default value for CLKQLN is 
20. 

The format of a clock message is: 

CLKMSG, ZBLOCK 3 /3 WORDS RESERVED FOR RTS/8 

COMMAND+TASKNO /TASKNO=0 MEANS TASKNO=SENDING TASK 

TIMEHI 

TIMELO 

EXTRAl 

EXTRA 2 

The words TIMEHI and TIMELO specify a time interval from the present 
time in terms of "system ticks". The user specifies the number of 
system ticks in a second in the RTS/8 parameter file by defining the 
parameter SHERTZ. The hardware tick rate (in ticks per second) is 
specified by the parameter HERTZ. CLKTYP and HERTZ are determined 
completely by the user's hardware configuration. SHERTZ equals the 
reciprocal of the software system clock resolution, HERTZ must be an 
exact multiple of SHERTZ. For example, the parameters for a 
line-frequency clock might be: 

DECIMAL 
HERTZ= 120 
SHERTZ= 10 

indicating that there will be 10 "system ticks" per second based on a 
60-cycle clock. Such parameters might be used if only 1/10 second 
resolution is necessary in the Clock Handler. Note that the maximum 
interval that can be expressed in TIMEHI and TIMELO is ( 2**24) /SHERTZ 
seconds. This is approximately three days if SHERTZ=60. 

Other RTS/8 system tasks use the symbol CLOCK when referring to the 
Clock Handler. The user should define this symbol in the RTS/8 
parameter file to be equal to the Clock Handler's task number. It 
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should be undefined if a Clock Handler is not to be included in the 
system. (See Chapter 6 for a description of the parameter file.) 

COMMAND is the type of request and has the following meanings: 



Octal 
0000 

1000 
2000 



Symbolic 
MARKTIME 

SCHEDULE 
TIMOUT 



3000 



SCHEDULE PERIODICALLY 



7000 



CANCEL 



Description 

POST the event flag CLKMSG after the 
specified interval elapses. TASKNO, 
EXTRAl, and EXTRA2 are ignored. 

POST CLKMSG immediately. Execute a 
RUN ER on the task specified by TASKNO 
after the specified interval elapses. 
EXTRAl and EXTRA2 are ignored. 

POST CLKMSG immediately. DERAIL the 
task specified by TASKNO into a 
subroutine whose address is specified 
in EXTRAl after the specified interval 
elapses. EXTRA2 is ignored. 

POST CLKMSG immediately. Execute a 
RUN ER on the task specified by TASKNO 
after the specified interval elapses, 
and re-queue this command with the 
parameters EXTRAl and EXTRA2 in place 
of TIMEHI and TIMELO. This has the 
effect of running the specified task 
periodically with a period specified 
by EXTRAl and EXTRA2. 

Cancel all the clock requests for the 
task specified by TASKNO. TIMEHI, 
TIMELO, EXTRAl, and EXTRA2 are 
ignored. POST CLKMSG immediately. 
Note that the requests are not 
actually deleted and that they still 
occupy space in the queue until they 
time out. 



10 



11 



Command: .^^-^^ 

MARKTIME 

1 SCHEDULE 

2 TIMOUT 

3 SCHEDULE PERIODICALLY 
7 CANCEL 



Task humber • 



Command Word Format - Clock Handler 
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The Clock Handler also maintains the current time-of-day (in system 
ticks until midnight), in symbolic locations TODH (high-order) and 
TOOL (low-order) in Page of Field 0. When this time-of-day reaches 
zero (i.e., at midnight), it is reset to the quantity - (SHERTZ*86400) 
(24 hours until midnight) and an OS/8-format date word in symbolic 
location DATE in Page of Field is incremented by one day. 

Note that in order for the quantity SHERTZ*86400 to be contained in 24 
bits, SHERTZ must be less than 192. If SHERTZ is larger, an assembly 
error will result while assembling the Clock Handler. 



4.1.1 Examples of Clock Handler Calls 



CAL 
SENDW 
CLOCK 
SLEEPM 



/WITH A 60HZ SYSTEM TICK RATE, 
/THIS CAUSES THE CURRENT TASK 
/TO "GO TO SLEEP" FOR 2 SECONDS, 



SLEEPM, 



ZBLOCK 3 



0;170 



/MESSAGE HEADER 

/SET EVENT FLAG AFTER INTERVAL 

/INTERVAL IS 120 (DECIMAL) SYSTEM 

/TICKS 



If the user changes the value 170 to the assembler expression 
2~SHERTZ, the preceding sequence becomes configuration-independent. 



CAL 
SEND 
CLOCK 
RUNMSG 



/RUN THE TASK REPORT ONCE 
/EVERY HOUR, INDEFINITELY, 
/ASSUMING A 60HZ SYSTEM TICK RATE 



RUNMSG, 



ZBLOCK 3 
SCHEDULE 



0;1 
64;5654 



/MESSAGE HEADER 
REPORT PERIODICALLY 

/RUN REPORT AFTER SPECIFIED 

/INTERVAL AND PERIODICALLY 

/THEREAFTER, 

/FIRST RUN IS ALMOST IMMEDIATELY 

/(1/60 SECOND) 

/PERIOD BETWEEN RUNS IS 216000 

/(DECIMAL) SYSTEM TICKS = 3600 

/SECONDS = 1 HOUR. 



4.2 TERMINAL HANDLER 

The RTS/8 Terminal Handler handles a single terminal in either line or 
character mode. Input in line mode is terminated by a carriage return 
or an ALTMODE character and may be edited using the RUBOUT and "U 
characters. The RUBOUT character deletes the last valid character 
typed and prints a backslash; the "U character deletes the entire 
line and returns the carriage. Character mode input is not echoed and 
is terminated by overflow of a specified character count. 

If multiple terminals are to be handled, multiple copies of this 
Terminal Handler must be assembled. Assembly parameters in the body 
of the handler specify which device codes the handler will use to 
access its terminal. These parameters also specify whether the 
handler is to be a "console" Terminal Handler, that is, the terminal 
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on which the MCR program is going to be run. The console Terminal 
Handler invokes the MCR whenever a "C is typed on the keyboard; 
nonconsole terminal handlers treat "C as any other character. For the 
console handler, "C wakes up MCR by POSTing an Event Flag. 

The parameters edited into the distributed version of the Terminal 
Handler assemble the handler to handle the PDP-8 console terminal as a 
"console" device. Thus, when the MCR function is required, both the 
MCR task and the Terminal Handler task must be assembled and included 
as part of the RTS/8 system. Modification of the Terminal Handler to 
support a VT50 terminal and other features are described in Section 
4.2.1. 



The format of messages to the Terminal Handler can be either 
following: 



of the 



ZBLOCK 3 
command +length 
INBUF 
OUTTXT 



ZBLOCK 3 
ASSGN+tsknum 



Description: 

Types text specified by 
OUTTXT and command, then 
reads text into INBUF. 



Description: 

ASSGN=200 

Assigns Terminal Handler to task specified 

Deassigns Terminal Handler if tsknum=0 



Legal Commands, which can be combined, are as follows: 

Octal Symbolic Action if specified Action if not specified 



4000 NOPACK 



2000 NOCRLF 



1000 IND 



0400 NOLINE 



Output text is in 
unpacked ASCII, one 
character per word 
terminated by a 0000. 

Do not type a CR/LF 
after the message. 

OUTTXT points to the 
first word of the 
output text. 

Input is in character 
mode ; terminated 
after 'length' input 
characters read. 



Output text is in 
packed 6-bit, two 
characters per word 
terminated by a 00. 

Type a CR/LF after 
typing the message. 

OUTTXT is the first 
word of the output text. 



Input is in line mode; 
terminated by a CR 
or ALTMODE (ESC) . The 
length is still tested, 



Length 



Is a seven-bit field which specifies the 
maximum size of the input buffer if input is 
in line mode, or the number of characters to 
input if input is in character mode. If 
input is in line mode and there are LENGTH-1 
characters in the input buffer, characters 
other than carriage return, ALTMODE, RUBOUT 
and "U will not be accepted or echoed the 
message Event Flag is Posted. 



INBUF 



Is a pointer to the input buffer; if it is 
zero, no input is taken. The input buffer is 
filled with input characters packed one per 
word with the parity bit (bit 4) forced on. 
If input is in line mode, the last character 
of the line is followed by a zero word (if a 
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OUTTXT 



ASSGN =200 



tsknum 



carnage return terminated the line) or a 
-1(1111) word {if an ALTMODE character 
terminated the line) . 

Is either the first word of the output text 
string (if IND=0) or a pointer to the first 
word of the output string (if IND=1000) ir 
the same field as the message. 



"Assigns" the 
specified task 
handler to onl 
specified task 
SEND a message 
it is assigned, 
the Terminal Ha 
but will not be 
Terminal Handl 
released. The 
Handler is 
assignment by s 
Terminal Handle 
operation is 
message. 



Terminal Handler to the 

This will cause the terminal 

y accept messages from the 

If another task tries to 

to the Terminal Handler while 

the message will be placed in 

ndler's Message Input Queue 

removed for processing by the 

er until the assignment is 

task to which the Terminal 

assigned can release the 

ending a message assigning the 

r to task number 0. No I/O 

performed by an assignment 



Is a 6-bit field used with the ASSGN command 
to specify the task number of the task to 
which the terminal is to be assigned. If 
this field is zero, the terminal is 
deassigned allowing the terminal task to 
accept commands from any task. 



Command (bits 0-4| 

0: Packed ASCII \ 
1: Unpacked ASCII) 



0: CR/LF at end of message ) 

1: No CR/LF at end of message) 

0: OUTTXT is the first word \ 

1 : OUTTXT points to first word ) 



0: Input in line mode \ 

1: Input in cliaracter mode 



Bit 4 must be a ■ 

Lengtii (bits 5-11) 

If bit 3=1, no. of characters to input ) 
If bit 3=0, maximum size of input buffer) 



10 



11 



Command and Length Word Format - Terminal Handler I/O Mode 
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Unused ■ 



Bit 4 must be a 1- 
Unused 



10 



11 



^ I, u V. 



3^ 



Task Number ■ 



Command Word Format - Terminal Handler ASSGN Mode 



4.2.1 Additional Assembly Parameters Affecting Terminal Handler 
Properties 

Several assembly parameters are available to the user as an aid in 
using the TTY task. This section describes these parameters. A 
summary of their default values is shown in Table 3-4. 



VT50 



WIDTH 



=n 



SCOPE 



Do not treat CTRL/S 
characters . 



and CTRL/Q as special 



Support CTRL/S and 
is enabled, typing 
printed/displayed 
data to stop unti 
This can be used o 
temporarily "fre 
parameter must be 
terminal is a mod 
terminals will 
synchronization 
computer of their 



CTRL/Q. If this 
CTRL/S while data 
on the terminal wi 
1 the next CTRL/Q 
n fast CRT term 
eze" the scree 
set to 1 if th 
el VT50 or VT52 si 

occasionally 
characters to 
own volition. 



feature 
is being 
11 cause 
is typed, 
inals to 
n. This 
e user 's 
nee these 
send 
the host 



Where n is an octal number that sets the page 
width to n characters. TTY width is 
currently set to 120(octal) characters. For 
example, setting the parameter 

WIDTH = 60 

changes the TTY page width to 80 (decimal) 
characters. After n characters are printed 
on the terminal, the handler will 
automatically type out a carriage-return 
line-feed. Sometimes it is desirable to 
suppress this CR/LF (for example, when using 
direct cursor addressing). In this case, 
WIDTH should be set equal to 0. 

This option is used to determine treatment of 
the RUBOUT key as follows: 

SCOPE=0 provides the normal mode of RUBOUT 
support (echo rubouts with a backslash) . 
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SCOPE=l causes RUBOUT to move the cursor left 
one position, physically removing the 
character from the screen. If the cursor is 
in column 1, RUBOUT still works, but has no 
visible effect. 



TAB 



This option is used to simulate tabs by the 

proper number of spaces. This is 

accomplished via the assembly parameter TAB 
as follows: 



TAB=0 specifies that the hardware does not 
support tabs. The software simulates tabs 
with spaces. 



FILL 



TAB=1 specifies that the hardware does 
support tabs. 

Fill characters are supported via the 
assembly parameter FILL as follows: 



CONSOL 



OLDTTY 



LSBOT 



FILL=0 provides no fill characters. 

FILL=n sends n fill characters (nulls) after 
a line feed. The number n must be in the 
range 1-5. FILL=4 is recommended for 2400 
baud VT05S. 

CONSOL = 1 means the handler is being 
assembled for the console terminal (default) . 

CONSOL = means that this handler will not 
wake up the MCR when a "C is typed. 

OLDTTY = 1 specifies the use of the old 
two-page handler which was supplied with 
RTS/8 version 1. This handler has fewer 
features than the new handler but it is a 
page shorter. The parameters VT50, WIDTH, 
SCOPE, TAB and FILL described herein have no 
effect when using this handler. 

OLDTTY = specifies the use of the new 
3-page terminal handler. 

LSBOT = 1 specifies the listing of both the 
old two-page and new three-page. 

LSBOT = (default) causes only the handler 
selected by the OLDTTY parameter to be 
listed. 



TTFLD 



TTLOC 



Specifies the field of the TTY Handler task; 
for example, 20 designates field 2. 

Specifies the starting location of the TTY 
Handler task; for example, 3000 designates 
the starting location at 3000. 
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Parameter 



VT50 

WIDTH 

SCOPE 

TAB 

FILL 

CONSOL 

OLDTTY 

LSBOT 

TTFLD 

TTLOC 



Table 4-1 
Suramary of Terminal Handler Assembly Parameter 
Default Values 



Default Value 



1 

120 







1 





10 

5000 



Meaning 



Support "S, "Q 

Page width of 80 (decimal) characters 

Rubouts echo as \ 

Simulate tabs 

No fill characters 

"C wakes up MCR 

Use 3-page TTY task 

List only TTY task selected by OLDTTY 

Not a default value, but given as an 
example to show that the given number 
assignments for TTFLD and TTLOC load the 
TTY Handler in field 1 starting at 
location 5000 



4.2.2 Useful Equates in the Parameter File 

Several useful equates (described in Section 4.2) are available which 
can be used when sending messages to TTY or LPT tasks. They are as 
follows: 



NOPACK 



4000 



NOCRLF = 2000 

IND = 1000 

NOLINE = 400 
ASSGN = 200 

KL8ALINE = 100 



Used if output message is not 6-bit ASCII 
format. 

Used if output message should not be followed 
by carriage return/line feed. 

Used if OUTTXT points to the first word of 
the output text. 

Used if input is in character mode. 

Used to assign the device handler for use 
only by this task. 

Used with KL8-A support (see Section 4.13.2). 



4.2.3 Examples of Terminal Handler Messages 

HIYA, 



ZBLOCK 3 





TEXT /HELLO/ 



/MESSAGE HEADER 

/PACKED TEXT, END WITH CR/LF, 

/NO INPUT 

/TEXT TO BE OUTPUT 



Sending the above message to the Terminal Handler prints HELLO on the 
terminal . 
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QUEST, ZBLOCK 3 /MESSAGE HEADER 

NOCRLF+60 /PACKED TEXT, NO CR/LF, 

/48-CHARACTER INPUT LIMIT 
ANSWER /POINTER TO INPUT BUFFER 

TEXT /TYPE THE ANSWER:/ 

^f.o^i!^'^ ^^^ ^'^°^® message to the Terminal Handler prints TYPE thp 
ANSWER: on the terminal and inputs a reply withouffirst retlrnlna 
the carnage The answer obtained from the above message could SI 
printed on the terminal by sending the following message: 



TYPANS , 



ZBLOCK 3 

NOPACK+IND 



ANSWER 



/MESSAGE HEADER 

/UNPACKED TEXT, INDIRECT, WITH CR/LF 

/NO INPUT 

/POINTER TO OUTPUT TEXT 



4.3 LINE PRINTER HANDLER 




INBUF word and the LINE bit are ignored (the INBUF word must, however 
be present m the message). ' ""^"^^"^^^ ' 



Command (bits 0-4) 

0: Packed ASCII I 
1: Unpacked ASCI I ( 



0: CR/LF at end of message ) 

1: No CR/LF at end of message/" 

0: OUTTXT is the first word 1 

1: OUTTXT points to first word/ 

0: Input in line mode ) 

1: Input in character mode ( 



10 



11 



Bit 4 must be a 0- 
Length (bits 5-111 



If bit 3=1, no. of characters to input ) 
If bit 3=0, maximum size of input buffer) 



Command and Length Word Format - Line Printer Handler I/O Mode 
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>» ,. M V. 



Unused ■ 



Bit 4 must be a 1 ■ 
Unused 



10 



11 



Task Number ■ 



Command Word Format - Line Printer Handler ASSGN Mode 



4.4 MASS STORAGE HANDLERS 

Handlers are available for TC08 DECtape , DF32 and RP08 fixed-head 
disks, RK8 and RK8E moving-head disks, RXOl floppy disks and LINCtape. 
All mass storage handlers accept the same message format to read or 
write blocks on various mass storage devices. However, the Floppy 
Disk Handler and the LINCtape Handler allow the use of additional 
parameters other than the ones described herein. These parameters are 
described in Sections 4.4.1 and 4.4.2. 

The format of messages to mass storage handlers is: 

MSMESG, ZBLOCK 3 
UNIT 

RW + PAGES + FIELD 
BUFADD 
BLOKNO 
STATUS 



where: 

UNIT 



RW 
PAGES 



Is the number of the logical unit 
is to be performed. DF32 and RF08 
one unit. TC08 DECtape has 
corresponding to its physical un 
logical units 0-7 corresponding to 
0-7. RK8 disk has logical unit 
its physical units 0-3. RK8E dis 
0-7. Units 0-3 correspond to 
number) half of physical units 
correspond to the inner (higher 
physical units 0-3, respectively, 
which corresponds to the le 
respectively. 



on which the operation 

disks consist of only 

logical units 0-7 

its 0-7. LINCtape has 

its physical units 

s 0-3 corresponding to 

k has logical units 

the outer (lower track 

0-3, and units 4-7 

track number) half of 

RXOl has units or 1 

ft and right drive, 



Is for a read operation, 4000 for a write operation. 

Specifies the number of (128-word) pages to transfer 
(times 100 octal). For example, PAGES=2000 specifies 
the transfer of 20(octal) pages or 2048 words; if 
PAGES=0, 40 (octal) pages or 4096 words are transferred. 
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Is the PDP-8 field in which the transfer takes place 
(times 10 octal). For example, if FIELD=30, the 
transfer takes place in field 3. 



The RW+PAGES+FIELD word is sometimes called the function word of the 
message. 



y\^ 



10 



11 



Reserved for task use • 
Unit 



Unit Word Format - Mass Storage Handlers 



0: Read operation 
1 : Write operation 



No. of pages to transfer . 
0-7: Field of transfer — 
Reserved for tasl< use 



10 



11 



Function Word Format - Mass Storage Handlers 



BUFADD Is the starting address of the buffer to be transferred. 

BLOKNO Is the block number on the device from which the 
transfer will begin. All devices are assumed to have 
256-word blocks. On DECtape, the first 128 words of 
each of an even/odd pair of 129-word DECtape records are 
considered to be a block. 



STATUS 



Is a word 
operation 
successf u 
which is 
Tasks whi 
this wor 
(that is, 
determine 
All RTS/8 
times if 
STATUS wo 



that the handl 

It contain 

1, otherwise it 

the contents 

ch use the mass 

d after the 

after the Eve 

if any erro 

mass storage h 

errors are 

rd to a nonzero 



er sets on co 


s a zero if 


will contain a 


of the device 


storage handl 


I/O operation h 


nt Flag has 


rs occurred dur 


andlers retry 


encountered be 



mpletion of the 

the operation is 

nonzero quantity 

status register. 

ers should test 

as been completed 

been POSTed) to 

ing the transfer. 

operations three 

fore setting the 



Note that the middle three words of a message to the RTS/8 mass 
storage handlers are identical to the arguments to an OS/8 handler 
when the same operation is performed. 
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4.4.1 Floppy Disk Handler 

Each copy of the Floppy Handler can control one single or dual RXOl 
drive; for more than one RXOl, multiple copies of the handler are 
required. The format of messages to the Floppy Disk Handler is: 

ZBLOCK 3 

CODE+DEL+MODE+UNIT 

RW+PAGES+FIELD 

BUFADD 

BLOKNO 

STATUS 



where! 



CODE 



DEL 



Regular condition. BLOKNO is interpreted as an 
OS/8 logical record number. Also, PAGES is 
interpreted in the OS/8 sense to mean the number 
of pages of data to transfer. The DEL bit is 
ignored. 

4000 Special Physical Sector Condition. PAGES is 
ignored. One sector is transferred. It is 
specified by BLOKNO which is to be interpreted as 
TTTTTTTSSSSS. That is, the high order 7-bits of 
BLOKNO represent the physical track number. This 
number must be in the range 0-76 decimal (0-114 
octal). The low order 5 bits of BLOKNO represent 
the sector number on that track. This number must 
be in the range 1-26 decimal (1-32 octal) . 

Deleted data marks should not be considered. 

2000 Handle deleted data marks (if CODE=4000) as 
follows: If writing a sector, write deleted data 
indication. Do not note this fact in STATUS word. 
If reading a sector, set bit 5 of STATUS word to a 
1 if read deleted data indication. In such a 
case, the STATUS word may be nonzero even though 
no physical error has occurred. Other STATUS bits 
are relevant and STATUS negative means hard error. 



MODE 



= 



Specifies transfer in 12-bit mode. 



UNIT 



100 Specifies transfer in 8-bit mode. 

OS/8 format uses 12-bit mode. In 12-bit mode, the 
64 12-bit words that comprise an OS/8 floppy 
sector are packed into the first 96 bytes of the 
sector, while the last 32 bytes contain random bit 
patterns. In 8-bit mode, an 8-bit byte on the 
floppy disk corresponds to the low order 8-bits of 
a 12-bit word in memory. Data in the high order 4 
bits of a word in memory is not transferred to the 
floppy disk. 

In 12-bit mode, a sector contains 64 (decimal) 
12-bit words of data. In 8-bit mode, a sector 
contains 128 8-bit bytes of data. 

Specifies the drive unit number. It may be or 
1. The number refers to the unit on the left of 
a dual drive. 
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0: Regular condition \ 

1: Special physical sector condition) 



0: Do not handle deleted 
1: Handle deleted mar 



ted marks) 
ks (■ 



0: Transfer in 12 bit mode) 

1; Transfer in 8-bit mode j 

0: Left unit of dual drive ) 

1: Right unit of dual drive) 
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10 



11 



CODE = 4000 (bit set to 1) transfers one sector specified by 
BLOCKNO as follows: 



Physical track no. — 
(0-114 octal) 

Sector no. on track . 
(1-32 octal) 



->'V^ 



10 



11 



Unit Word Format - Floppy Disk Handler 



Hard error- 



Deleted data 
INIT done- 



Parity error 
CRC error - 



10 



11 



Status Word Format - Floppy Disk Handler 



The largest legal OS/8 block number on a floppy disk is 755 octal. If 
block 756 is referenced, an error is generated. Use of larger block 
numbers may produce unpredictable results. Specifying an illegal 
track or sector may produce an error with STATUS = 4000. 
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The Standard OS/8 Interleave Scheme is as follows: 



OS/8 Logical Block (octal) 


Floppy 


Sectors 


(track/sector in decimal 





1/1, 


1/3, 


1/5, 


1/7 




1 


1/9, 


1/11, 


1/13, 


1/15 




2 


1/17, 


1/19, 


1/21, 


1/23 




3 


1/25, 


1/2, 


1/4, 


1/6 




4 


1/8, 


1/10, 


1/12, 


1/14 




5 


1/16, 


1/18, 


1/20, 


1/22 




6 


1/24, 


1/26, 


2/1, 


2/3 




7 


2/5, 


2/7, 


2/9, 


2/11 




10 


2/13, 


2/15, 


2/17, 


2/19 




11 


2/21, 


2/23, 


2/25, 


2/2 




12 


2/4, 


2/6, 


2/8, 


2/10 




13 


2/12, 


2/14, 


2/16, 


2/18 




14 


2/20, 


2/22, 


2/24, 


2/26 




15 


3/1, 


3/3, 


3/5, 


3/7 





Track is not used by OS/8, and cannot be accessed in the 12-bit 
mode. 



4.4.2 LINCtape Handler 

The LINCtape Handler supports both OS/8 and DIAL format LINCtapes. 
The format of messages to the LINCtape Handler is: 

ZBLOCK 3 

MODE+UNIT 

RW+PAGES+FIELD 

BUFADD 

BLOKNO 

STATUS 



where: 

UNIT= 



Specifies the LINCtape unit number in range to 

/ • 



MODE=0 



Specifies OS/8 Mode. A LINCtape is presumed to 
contain 200 or 201 (octal) words per physical 
block. 
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= 4000 



RW =0 

= 4000 
PAGES 



FIELD 



BUFADD 



BLOKNO 



STATUS 



Specifies DIAL Mode. A LINCtape is presumed to 
contain 400 (octal) words per physical block. 

Note: The LINCtape used is not checked to see if 
it is properly formatted for the specified mode. 
Use of a LINCtape with improper physical format 
will produce unpredictable results. 

Read data from LINCtape 

Write data to LINCtape 

Specifies the number of 128-word pages to transfer 

(times 100 octal). For example, PAGES=2000 

transfers 20 octal pages or 2048 words; if 

pages=0, 40 octal pages or 4096 words are 
transferred. 

Specifies the PDP-8 field in which the transfer 
takes place (times 10 octal). (For example, 
FIELD=30, the transfer takes place in field 3). 

Is the starting address of the buffer to be 
transferred. 

Is the block number on the device from which the 
transfer will begin. All devices are assumed to 
have 256-word blocks. On OS/8 LINCtapes, two 
consecutive physical blocks comprise one OS/8 
logical block. Only the first 128 words in each 
physical block contain meaningful data. 

When running in DIAL mode, BLOKNO represents a 
physical LINCtape block number. In this case, 
PAGES must be even because an even number of pages 
is transferred. If PAGES is (incorrectly) odd, 
the last page is not transferred, except if 
PAGES=1 which will result in one block (2 pages) 
being transferred. 

is the ones complement of tape check (checksum) • 
The value means no error. STATUS is always on 
a Write operation. Three software retries are 
attempted on a checksum read error. Note that the 
hardware performs infinite retries on most errors 
(write-lock-out, tape not mounted, bad spot on 
tape) and does not return control to RTS/8 until 
successful . 



CAUTION 

In the OS/8 mode, the word following the 
end of the buffer is temporarily 
destroyed while a LINCtape operation is 
in progress. The location is then 
restored upon completion of the 
operation. However, since RTS/8 is a 
real-time system, code may be executing 
while the tape operation is in progress. 
The user must make sure that this word 
is never referenced while the LINCtape 
is being used. Under no circumstances 
should the word following the end of the 
buffer belong to another task. 
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1 


2 


3 


4 


5 


6 


7 


8 


9 


10 


11 




. 


. 












V 






. 






"^ 






0: OS/8 mode ( 






















1: UIAL mode) 






Unit niimhor 





















Unit Word Format - LINCtape Handler 



4.4.3 Example of Mass Storage Handler Call 



CAL 

SENDW 

DTA 

DTAMSG 
TAD STATUS 
SZA CLA 
JMP ERR 



/SEND A MESSAGE TO THE DECTAPE 

/HANDLER 

/AND WAIT FOR COMPLETION 

/CHECK THE STATUS OF THE OPERATION 

/BAD - GO TO ERROR ROUTINE 
/OK - CONTINUE PROCESSING 



DTAMSG, 



STATUS , 



ZBLOCK 3 

4 

4210 

BUFFER 

55 





/MESSAGE HEADER 

/DECTAPE UNIT 4 

/WRITE 256 WORDS FROM FIELD 1 

/ADDRESS OF BUFFER 

/INTO BLOCK 55 (RECORDS 132 & 



/STATUS OF OPERATION STORED HERE 



133) 



4.5 POWER FAIL TASK 

The Power Fail Task provide 
recovers from power failure 
option is present and if the 
nonzero value, the SPL (Skip 
the interrupt skip chain. I 
processor state is saved 
comes back, the processor sta 
POSTed which wakes up the 
restores the clock, console t 
present, and also performs an 
on the contents of an interna 
in this table, which contains 



s the mechanism 
If the power-fa 
system parameter 

on Power Low) in 
f a power low 
and the processo 
te is restored 

Power Fail Ta 
erminal, and OS/8 

action for each 
1 table. Each ta 



by which the system 
il/auto-restart hardware 
PWRFAL was equated to a 
struction is included in 

condition occurs, the 
r is halted, when power 
and an Event Flag is 
sk. The Power Fail Task 

terminal if they are 
task in the system based 
sk has a one-word entry 



-1 



If nothing should be done for this task (default value) 

If the EFWT (Event Flag Wait) bit should be cleared in 
the Task Flags Table entry for this task (i.e., this 
task should be taken out of Event Flag Wait) 
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ADDR If the task should be DERAILed to location ADDR in the 
field in which it is executing as well as having its 
EFWT bit cleared. 

Each task in the system may alter its entry in the Power Fail Task's 
table by sending a message to the Power Fail Task. The format of the 
message is: 

PWRMSG, ZBLOCK 3 
WORD 



where; 



WORD is the new contents of the Power Fail Task's table entry 
for the sending task. 



4.6 OS/8 SUPPORT TASK 

The OS/8 Support Task supports the execution of the OS/8 operating 
system as a task under RTS/8. OS/8 is run in the top two or more 
memory fields under control of the KM8-E memory extension and 
timeshare option (standard on PDP-8/E, 8/F, or 8/M with 8K or more of 
core memory) or TSS-8 time sharing hardware option. 



NOTE 

A jumper on the KM8-E module is used to 
select the timeshare function. The 
module is shipped with this jumper in 
place (timeshare function disabled) . 
The PDP-8A utilizes the memory extension 
and timeshare option provided by the 
KM8-A extended option board. A switch 
on the KM8-A module is used to enable 
the timeshare function. 



The OS/8 Support 
establish a cor 
tasks. Terminal 
several character 
CPU by tasks of h 
trapped CDF instr 
(CUSPs) , response 
still quite rea 
system device tha 
OS/8 Support Task 



Task is configured at system startup time to 
respondence between OS/8 devices and RTS/8 handler 
input and output from OS/8 are ring-buffered by 
s to minimize input loss due to the usurpation of the 
igher priority. Because of the large number of 
uctions in OS/8 and its Commonly Used System Programs 

time is slower than a stand-alone OS/8 system but 
sonable. The background OS/8 task must have the same 
t was used by the. OS/8 system to load RTS/8. The 

cannot run on a stand-alone PDP-8 without OS/8. 



Several parameters in the system parameter file control the assembly 
of the OS/8 Support Task. The parameters and their meanings are as 
follows: 



OSFLDS 



OSKBDV 



Defined as the number of fields to be dedicated to 

OS/8. 

Example: 0SFLDS=2 specifies two fields or 8K of 

memory for OS/8. 

Set equal to the keyboard lOT code of the OS/8 

terminal . 

Example: OSKBDV=03 specifies the use of the 

console terminal keyboard of OS/8. 

Note: OS/8 requires its own dedicated terminal. 
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OSTTDV Set equal to the teleprinter lOT code of the OS/8 
terminal . 

Example: OSTTDV=04 specifies the use of the 
console teleprinter for OS/8. 

°^^^^^ Specifies how many null characters must follow a 
Ime-feed character on the OS/8 terminal. This 
allows high-speed VT05 terminals to be used as 
OS/8 terminals. For standard Teletypes^ and 
DECwriter terminals, this parameter should be 
set to zero. 

Example: 0SFILL=4 allows the use of a 2400 baud 
VT05. 

OSSYSD Specifies the OS/8 system device driver task. 

Example: OSSYSD=DTA specifies DTAO as the OS/8 
system device. 

NOTE 

The user does not need to include a 
terminal driver for the OS/8 terminal 
device (it is built into 0S8SUP) . 

The OS/8 system that runs under the OS/8 Support Task runs all OS/8 
CUSPS except BUILD, BOOT, PIPIO, INDUSTRIAL BASIC, and BASIC and 
FORTRAN LAB runtime functions. All references to the keyboard and 
teleprinter are diverted to the specified OS/8 keyboard and 
teleprinter. References in OS/8 to the LE8, LS8E, LP8 or LV8 line 
printers are diverted to the RTS/8 line printer handler if the system 
parameter LPT is defined; otherwise they are executed directly by the 
Support Task. References to the following OS/8 device names will be 
diverted to the corresponding RTS/8 handler if one is defined: 

DTA0-DTA7 
LTA0-LTA7 
RKA0-RKA3 
RKB0-RKB3 
RXA0-RXA7 

If one is not defined, OS/8 will perform the I/O directly usinq the 
standard OS/8 handler. 

In addition, the OS/8 handlers SYS and DSK are diverted to the handler 
specified by the parameter OSSYSD. Other references to I/O under the 
supported OS/8 system may cause the OS/8 support task to hang in a 
loop. References to a handler called RTS8 are diverted to 0S8C0M (see 
Section 4.7). 



4.6.1 Mapping of Fields with OS/8 Support Task 

The parameter HGHFLD in the parameter file must specify the highest 
field available to the entire RTS/8-OS/8 system. This is usually the 
highest field available in memory (e.g., 30 for a 16K machine). The 
0S8SUP task maps OS/8 fields into real fields as follows. The field 
which OS/8 uses as field is actually HGHFLD. OS/8 fields 1, 2, 3, 
etc. are mapped into consecutive fields beginning with field 



Teletype is a registered trademark of the Teletype Corporation. 
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HGHFLD-OSFLDS+1, proceeding upward. If an OS/8 program references a 
field greater than HGHFLD, unpredictable results will occur, as these 
fields are mapped over the lower OS/8 fields.. The software core size 
is correctly set to OSFLDS and should be used by multi-field OS/8 
programs. 



4.7 OS/8 - RTS/8 COMMUNICATION (0S8C0M) 

The OS/8 Support Task contains a mechanism by which OS/8 can talk to 
an RTS/8 task. To perform this communication, the OS/8 system must be 
configured with a handler called RTS8. This handler can be a dummy; 
it need not do anything. In fact, it can be some other handler to 
which the name RTS8 has been assigned. The OS/8 Support Task traps 
all calls to this handler. The arguments that are passed to the RTS8 
handler by an OS/8 program will be passed to an RTSB task called 
0S8C0M. The user is responsible for writing this 0S8C0M task. 

The 0S8C0M task performs an RTS/8 RECEIVE ER. The task can then 
receive a message any time an OS/8 program reads or writes to the RTS8 
handler. This message looks like any other message to a mass storage 
device. 0S8SUP does make one change to the arguments. Bits 6 through 
8 of the function word originally contain the field of the buffer. 
This is the field where OS/8 expects the buffer to be. When 0S8C0M 
gets control, these bits identify the actual field that contains the 
buffer. 0S8C0M can return information to OS/8 through these 
arguments . 



4.7.1 Using the 0S8C0M Task 

An OS/8 program that runs an RTS/8 task as specified by the OS/8 user 
is shown in the following example. 

Example: 

USR=7700 /LOCATION OF OS/8 USER SERVICE ROUTINE 

JMS PRINT /PRINT MESSAGE "WHAT TASK WOULD YOU 
/LIKE TO RUN?" ON THE OS/8 TERMINAL 

JMS READ /READS RESULT FROM OS/8 KEYBOARD 

/RETURNS TASK NUMBER IN RANGE 1-77 
/ IN AC 

DCA TASKNUM /STORE IT AWAY 

CIF 10 

JMS I (USR /CALL USR 

1 /TO DO A FETCH 

DEVICE RTS8 /OF DEVICE 'RTSS' 
ENTRY, ADDR /DUMMY ADDRESS (HANDLER WILL ALREADY 

/BE RESIDENT 

HLT /ERROR (HANDLER NOT FOUND) 

/NOTE THAT THIS CODE IS NOT REUSABLE AND THAT LOCATION 
/'ENTRY' IS SET TO THE ENTRY POINT FOR THIS HANDLER 

CIF 

JMS I ENTRY /CALL HANDLER 

/DUMMY READ 

TASKNUM, /TASK NUMBER 

ZBLOCK 2 /DUMMY 

JMP I (7605 /RETURN TO OS/8 

It should be noted that TASKNUM is being passed as the second argument 
instead of the first because 0S8SUP automatically modifies bits 6-8 of 
the first argument, presuming that a mapped field number is located 
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there. 0S8C0M expects three arguments after the handler call plus an 
error return. These must be specified by the user. 

Where the OS/8 portion of the program has been written, the 0S8C0M 

task that handles the RTS/8 side of the communication must be written. 

0S8C0M is written like any other RTS/8 user task, and an examole of 
what it might look like is as follows: 



START, 
MADDR, 
MSGFLD, 



TASK=0S8C0M 

INIWT=0 

CUR=40 

FIELD CUR%10 

*200 

CAL 

RECEIVE 



DCA MSGFLD 

HLT 

ISZ MADDR 

ISZ MADDR 



TAD 
CAL 
RUN 



I MADDR 



EFCDF, 



TAD MSGFLD 
DCA EFCDF 
TAD (-5 
TAD MADDR 

CAL 

POST 

HLT 

JMP START 



/0S8C0M IS ASSIGNED A PRIORITY IN THE 
/PARAMETER FILE 
/COMES UP RUNNING 
/SPECIFY FIELD HERE 

/STARTING ADDRESS 

/IMMEDIATELY GO INTO RECEIVE WAIT 
/ADDRESS OF MESSAGE LEFT HERE 
/CDF TO MESSAGE FIELD LEFT IN AC 

/POINT TO FUNCTION WORD 
/POINT TO BUFFER ADDRESS 
/{SECOND OS/8 ARGUMENT) 
/GET TASK NUMBER 

/RUN THIS TASK 

/0S8C0M WANTS TO BE HIGHER 

/PRIORITY THAN TASK IT IS RUNNING 



/GET ADDRESS OF EVENT FLAG 
/FOR MESSAGE 

/POST MESSAGE 

/GET ANOTHER MESSAGE 



In this example, the task number was put in the second argument of the 
OS/8 call. However, it became the third word of the RTS/8 message 
because 0S8SUP always adds a word to the mass storage call argument 
list, namely the unit number. For a description of the OS/8 standard 
handler call format, see Section 4.1 of the OS/8 Software Support 
Manual. For a description of the standard message format for mass 
storage devices, see Section 4.4 of this manual. 



4.7.2 Other Techniques 

Other techniques which can be employed by the user are as follows: 

1. If the RTS/8 handler STATUS word (word 5) of the message 
posted by 0S8C0M is nonzero, then return is taken to OS/8 at 
the error return of the handler call. 

2. Arguments may be passed back to OS/8 through the argument 
list. 

3. If more than three words of data need to be passed to 0S8C0M 
from OS/8, the user can pass a CDF and address of the area 
where the data resides. If the CDF occurs as the first 
argument to the handler call, it automatically will be 
relocated before being passed to 0S8C0M. 
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4.8 OS/8 FILE SUPPORT TASK 

The OS/8 File Support Task (OSBF) allows other tasks to look up, 
create, and delete files in OS/8 directories. This task is included 
in the same source file as the OS/8 Support Task, but the user can 
assemble it independently of that task (depending on which tasks are 
defined in the system parameter file). The format of messages to 0S8F 
is: 



OSFMSG, ZBLOCK 3 

DEVHND"10+UNIT+FUNCT 

FILPTR 

STATUS 

BLOKNO 

LENGTH 



where ; 



DEVHND 



Is the task number of the handler for the 
device. 



desired 



UNIT 



FUNCT 



Is the unit number on which the operation is to be 
performed. 



Represents the function to be performed, 
have the following values: 



It can 



Looks up the specified filename and returns 
its starting block number in BLOKNO, and its 
length in LENGTH (as a two's complement 
number) . 

2000 Enters the specified filename into the first 
empty space (on the device) whose length is 
equal to or exceeds the value in LENGTH. 
Returns the starting block number of the new 
file in BLOKNO. If a file of the same name 
previously existed on the device it is 
deleted. The value of LENGTH is unchanged. 



FILPTR 



STATUS 



4000 Deletes the specified filename. 

Is a pointer to a 4-word filename in the same 
field as the message. The PAL8 pseudo-op FILENAME 
can be used to generate these filenames. 

Describes the final status of the operation as 
follows: 



Operation successful. 

1 File not found on Lookup or Delete. 

2 No room for file on Enter. 

>2 I/O error occurred. The value is 

hardware error status of the device. 
-1 Invalid directory on device. 



the 
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Function: - 

Lookup 

1 Enter 

2 Delete 

3 Unused 



Unused - 



Task number . 
Unit 



Vw. 



10 



11 



0S8F Call Function Word 



If both 0S8F and the OS/8 Support Task are present in a system, an 
interlock is set up to prevent simultaneous updating of directory 
blocks by both systems. Because OS/8 tends to leave directory blocks 
in memory for long periods of time, this interlock scheme causes 
lengthy delays for the 0S8F task. Before a Delete or Enter operation 
is performed, 0S8F waits until OS/8 is in a state in which: 

1. There is no active temporary file on the OS/8 device 
corresponding to DEVHND and UNIT. 



OS/8 has just loaded the Keyboard Monitor, 
or USR into core. 



Command Decoder, 



Look up operations are not interlocked since they do not modify the 
directory. 



4.9 UNIVERSAL DIGITAL CONTROLLER/INDUSTRIAL CONTROLLER SUBSYSTEM 
(UDC/ICS) HANDLER 

The UDC/ICS handler gives the user the capability to control the 
various types of UDC/ICS functional devices. This handler performs 
two types of action: immediate and associated. Immediate actions 
include reading and sending analog and digital values to appropriate 
UDC/ICS functional devices. Associated actions can be linked to 
specified events within the UDC/ICS (counters overflowing, switches 
being thrown). The associated actions can do the following: 

1. Run a specified task when the event occurs 

2. Set the' Event Flag when the event occurs 

3. DERAIL a specified task when the event occurs 

The number of associated requests that can be pending simultaneously 
IS determined by the size of the buffer, which is specified bv the 
assembly parameter RINGBUF. 
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The UDC/ICS handler permits the following operations: 

1. Analog Output - send a 10-bit value to an analog channel 

2. Analog Input - accept input from analog subchannel 

3. Digital Output - send a 12-bit value to a digital channel 

4. Digital Input - read a digital channel 

5. Get Generic Code - determine the generic code for a 

specified channel 

6. Enable Counter - permit interrupts from a counter channel 

7. Read Counter - read current value of the counter 

channel 

8. Disable Counter - disable interrupts from a counter 

channel 

9. Enable Contacts - permit interrupts from a contact channel 

10. Change Of State - find the current COS value for a contact 

channel 

11. Disable Contacts - ignore interrupts from a contact channel 

Each operation is discussed in detail below, including the format of 
the message for specifying the operation. The first three words are 
required for use by the Executive. Word 4 specifies one of the 11 
UDC/ICS operations which are as follows: AO=0; D0=1; DI=2; GC=3; 
EC=4; RC=5; DC=6; ECT=7; CS=10; DCT=11; AI=12. Word 5 
designates the channel being used for the indicated operation. Words 
6 through 8 may be required to completely specify the operation, and 
the number used is dependent upon the operation. The word that 
follows the last word specifying the desired operation is used for the 
value read or the value returned. Word 10 of all UDC/ICS messages 
contains the error state. 

The general format for a UDC/ICS message is: 

ZBLOCK 3 

OPERATION 

CHANNEL 

OPWORDl 

0PW0RD2 

0PW0RD3 

VALUE 

STATUS 



4.9.1 AG Analog Output 

Format: AO 

channel number 
subchannel & value 

Channel number is the analog output channel. The subchannel and value 
word is formed by the subchannel (0-3) in bits and 1 and the 10-bit 
value in bits 2-11. For example, a message for an analog output 
operation: 
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AOEX, 



AOER, 



ZBLOCK 3 

AO 

23 

4614 

ZBLOCK 3 





/ANALOG OUTPUT 

/CHANNEL 23 

/SUBCHANNEL 2, VALUE 614 

/ERROR INDICATOR 






1 


2 


3 


4 


5 


6 


7 


8 


9 


10 


11 


*^ s 


i 


^. 



Subchannel . 
Value 



Subchannel and Value Word Format - UDC/ICS Handler 



4.9.2 AI Analog Input 

Format: AI 

channel 

subchannel & gain 
answer 

where channel is the analog input channel. The subchannel and gain 
word need only specify the gain in bits 1-3 and the subchannel in bits 
9-11 for UDC, and 5-11 for ICS. The handler automatically sets bit 
(enable conversion) and read control register (UDC bit 8; ICS bit 4) . 
The ICS analog converters must have addresses which are less than 20 
(octal) since all converter modules must be located in the first 16 
slots of the ICS unit. After conversion, the digitized value is 
placed in the answer word. 



Enable conversion - 
Gain 



ICS read control register; 
(for UDC, bit 8) 



ICS subchannel; 

(for UDC, bits 9-11) 



a ^ 



-^ -1 V^ 



10 



11 



Subchannel and Gain Word Format - UDC/ICS Handler 
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An example of a message for an analog input operation is as follows: 

/ANALOG INPUT 
/CHANNEL 17 
/SUBCHANNEL 3, GAIN 1 
/RESULT HERE 

/ERROR INDICATOR 

The user should ensure that for each major channel there is sufficient 
time (approximately 250 microseconds for UDC; 5 milliseconds for ICS) 
for each subchannel conversion to be completed before another is 
indicated. In general, it may be helpful if all A/D conversions for a 
major channel are initiated from the same task. 



AIEX, 


ZBLOCK 3 




AI 




17 




3 


AIANS, 







ZBLOCK 2 


AIERR, 






4.9.3 DO Digital Output 

Format: DO 

channel 
value 

Channel is a legal digital output channel and value is the number to 
be output. For example: 



DOEX, 



DOER, 



ZBLOCK 3 

DO 

20 

7777 

ZBLOCK 3 





/DIGITAL OUTPUT 
/CHANNEL 20. 
/VALUE = 7777 

/ERROR INDICATOR 



4.9.4 DI Digital Input 



Format ! 



DI 

channel 

result 



Channel is the appropriate digital input channel and result will 
contain the value of the channel when read. For example: 



DIEX, ZBLOCK 3 

DI 

27 
DIANS, 



DIER, 



ZBLOCK 3 




/DIGITAL INPUT 

/CHANNEL 27 

/VALUE OF CHANNEL 27 WILL BE PUT 

/HERE 

/ERROR INDICATOR 



4.9.5 GC Generic Code 



Format: 



GC 

channel 

result 
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The generic code of the specified channel 
example : 



GCEX, 



is put in result. 



For 



ZBLOCK 3 

GC 

27 



ZBLOCK 3 





/DETERMINES GENERIC CODE 

/CHANNEL 27 

/GENERIC CODE PUT HERE 

/ERROR INDICATOR 

follows: - No 



GCANS, 
GCER, 

Generic codes are as follows: - No interrupt; 1 - Controller 
error; 2,3 - Contact Interrupt Modules; 4 - Counter Module; 7 - A/D 
converter. ' 



4.9.6 EC Enable Counter 

Format: EC 

channel 
initial value 
reload value 
event action 
address 

Channel is the counter channel to be enabled, initial value is the 
first value to be loaded into that channel, and reload value is the 
value with which to reload the channel after every event If the 
reload value is 0, the counter is not reloaded. The event'action and 
address words specify what happens when the counter interrupts. There 
are three mutually exclusive possibilities, indicated by settinq the 
appropriate bit m the event action word as follows: 



Bit 0=1 



Bit 1 = 1 - 



Bit 2=1 - 



Bit 3 



1 - 



Set Event Wait Flag of this job; continue 
execution of this job when the event occurs. 
Address word not used. 

Run a task that sent the message; run task 
specified by bits 4-11 of event action word. 
Address word not used. 

DERAIL the task that sent the message; the 
address word is only used by the DERAIL operation 
and specifies the address of the DERAIL 
subroutine. The subroutine must be in the same 
field as the calling task. 

Do action just once. If bit 3=0, specified 
action is performed after each interrupt. Bit 3 
indicates whether action is to occur once or 
repeatedly. 



Several enable counter examples follow: 



ECEXl, 



ECERl, 



ZBLOCK 3 

EC 

4 

7700 

7710 

4000 






/ENABLE COUNTER 

/CHANNEL 4 

/INITIAL VALUE OF 7700 

/RESET TO 7710 AFTER EACH EVENT 

/POST EVENT FLAG ON EVENT EVERY TIME 

/IT OCCURS 

/UNUSED 

/ERROR INDICATOR 
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ECEX2, 



ECER2, 
ECEX3, 



ECER3, 



ZBLOCK 3 

EC 

4 

1205 



2016 




ZBLOCK 3 

EC 

5 

10 

7700 

1015 

5620 




/ENABLE COUNTER 

/CHANNEL 4 

/INITIAL VALUE OF 1205 

/DON'T RESET 

/RUN TASK 16 ON EVENT EVERY TIME IT 

/OCCURS 

/UNUSED 

/ERROR INDICATOR 



/ENABLE COUNTER 

/CHANNEL 5 

/INITIAL VALUE OF 10 

/RESET TO 7700 

/DERAIL TO TASK 15 EVERY TIME IT 

/OCCURS 

/AT LOCATION 5620 

/ERROR INDICATOR 



4.9.7 RC Read Counter 



Format: RC 

channel 
result 

where channel is the counter channel whose current value is to be 
read. That value is placed in result. For example: 



RCEX, ZBLOCK 3 

RC 

6 
RCANS , 

ZBLOCK 3 
RCER, 



/READ COUNTER 

/CHANNEL 6 

/VALUE OF CHANNEL 6 PUT HERE 

/ERROR INDICATOR 



4.9.8 DC Disable Counter 



Format: DC 

channel 

where channel is the counter channel from which interrupts are to be 
ignored. For example: 



DCEX, ZBLOCK 3 

DC 

6 
DCER, ZBLOCK 4 





/DISABLE COUNTER 
/CHANNEL 6 

/ERROR INDICATOR 



4.9.9 ECT Enab 

Format: 



Contacts 



ECT 

bit & channel 

event action 

address 
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where the bit & channel word specifies the bit on the contact channel 
from which to enable interrupts. Channel is specified in bits 4-11 
and the contact bit is packed in bits 0-3 as a value from 0-13(octal). 

Event action and address are specified in the same manner as in the 
enable counter function. For example: 



ECTEXl, ZBLOCK 3 
ECT 
5401 
2013 
ZBLOCK 3 

ECTEIR, 

ECTEX2, ZBLOCK 3 
ECT 
1001 
4000 

ZBLOCK 3 
ECTE2R, 



/ENABLE CONTACTS 

/FROM BIT 13 (OCTAL) OF CHANNEL 1 

/RUN TASK 13 AFTER AN EVENT OCCURS 

/ERROR INDICATOR 



/ENABLE CONTACT 

/FROM BIT 2 OF CHANNEL 1 

/ON 1ST OCCURRENCE OF EVENT, POST 

/EVENT FLAG 



/ERROR INDICATOR 
Twelve messages are required to enable the entire channel. 



4.9.10 CS Change of State 



Format: 



CS 

channel 

result 



where channel is the contact channel whose current chanae of state 
value is to be placed in result. For example: 



COSEX, ZBLOCK 3 

CS 

1 
COSANS, 

ZBLOCK 3 
COSER, 



/READ COS 
/CHANNEL 1 
/RESULT HERE 

/ERROR INDICATOR 



4.9.11 OCT Disable Contacts 



Format! 



DCT 

bit & channel 



where bit & channel is specified as in enable contact. That is, bits 
0-3 specify the bit (0 - 13 octal) and bits 4-11 specify the channel 
to be disabled. For example: 



DCTEX, ZBLOCK 3 
DCT 
5401 

ZBLOCK 4 
DCTANS, 



/DISABLE CONTACTS 
/FROM CHANNEL 1, BIT 
/13 (OCTAL) 

/ERROR INDICATOR 
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4.9.12 UDC/ICS Assembly Parameters 

The UDC/ICS handler has several assembly parameters that the user must 
specify to indicate the UDC/ICS configuration. The number and address 
is required only for those modules that perform interrupts. They are 
as follows: 



RINGBF 

NCNTR 
NCNTC 
NAD 
FCTR 

FCT 
FAD 
NMPLX 



be stored in the 



Number of interrupts that can 
ring buffer. 

Number of counter modules. 



Number of contact modules. 

Number of analog input converter modules. 

Address of the first counter module. The modules 
must be at contiguous module addresses. 

Address of the first contact interrupt module. 
Interrupt modules must be at contiguous module 
addresses. 

Address of the first A/D converter module. Analog 
input modules must be at contiguous module 
addresses. 

Number of multiplexer modules per analog converter 
(ICS only) . 



These parameters are used mainly to specify the sizes of several 
tables in the UDC/ICS handler, allocated as 30 (octal) words per 
contact module, 3(octal) words/counter module, and 16(octal) words per 
analog module. The UDC/iCS handler currently assumes that the handler 
and all its tables are entirely within the same data field (although 
the user could easily reprogram this) . 

The user must keep in mind when establishing RINGBF size that if the 
buffer is full, UDC/ICS interrupts are disabled until there is room in 
the buffer. Also, each interrupt requires two entries in the buffer; 
that is, the actual buffer size is 2 * RINGBF. 



4.9.13 UDC/ICS Error Conditions 

To indicate error conditions, the UDC/ICS handler places a value in 
the tenth word of the task's message. The values and meanings are: 



Value 
1 

2 
3 
5 



Meaning 

Illegal generic code for specified channel and 
operation 

Channel or subchannel value not valid 

Illegal function code 

UDC/ICS control not responding (power off or 
hardware error) 
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The user should initialize and check the error word. A no error 
condition puts a in this location. 

Only errors encountered at noninterrupt time are returned in this 

manner, thus they may also indicate a faulty UDC/ICS hardware 

functional device. Generic codes of or 1 encountered at interrupt 
time are ignored. 



4.10 CASSETTE HANDLER 

The Cassette Handler (CSA) allows the user to read and write 
variable-length records on DEC cassettes, as well as to perform 
various special functions (such as rewind and write end-file). One 
copy of the Cassette Handler can operate eight units. 

There are two general categories of cassette operation: 

1. Handler functions - read and write 

2. Utility functions - rewind, backspace file gap, write file 
gap, backspace block gap, and skip to file gap 

The user should call these functions in a meaningful sequence. The 
first word of the message defines the cassette unit and either the 
handler or utility call. 



4.10.1 Handler Function 

The format of a message to the Cassette Handler when using a handler 
call is: 

ZBLOCK 3 

CALL + UNIT 

RW + FIELD + NONSTORE 

BUFADD 

SIZE 

STATUS 

For a handler function, the words after the RTS/8 message header are 
defined as follows: 

Word 1 bit 0=0 Utility call 
bit 1=0 Handler call 
bits 9-11 Cassette unit 

Word 2 bit 0=0 Read 
0=1 Write 
bits 6-8 Field of buffer 

bit 11 Do not store data (applicable to read 

only) 

Word 3 Buffer address 

Word 4 Record size in bits 4-11 

Word 5 Status return 
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0: Hand! 
1: Utility 



er call) 
I call ) 



10 



11 



\_ 



Unit- 



Unit Word Format - Cassette Handler 








1 


2 


3 


4 


5 


6 


7 


8 


9 


10 


11 












V 








; 








0: Read I 










1: Write) 






0: Read into merr 


ory 


I 



















1 : Check data 



Function Word Format - Handler Call 



Cassette conventions specify a record size of 200 bytes, but the user 
can use any size up to 377 {8 bits are transferred). The buffer 
specified by the message cannot cross field boundaries. For a read 
operation, the buffer is optional (although its word in the message 
must be included) , according to bit 11 of word 2. The^ nonstore 
capability can be used for advancing through a long file. Word 5 
contains the contents of status register B, which is defined by the 
bit setting as follows: 



Bit 



Meaning 



4 = 


CRC /block error 


5 = 


Timing 


6 = 


EOT/BOT 


7 = 


EOF 


8 = 


Drive empty 


9 = 


Read/write 


10 = 


Write lockout 


11 = 


Ready 
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CRC/block error . 
Timing . 



EOT/BOT. 



EOF 



Drive empty . 
Read/write - 



Write lookout 
Ready 



10 



11 



Status Return Word Format - Cassette Handler 



At the end of each cassette operation, the user should examine Word 5 
to check for errors encountered. 

An example of a cassette handler message to write 100 bytes from a 
buffer starting at 21200 to cassette unit 3 is as follows: 



MSGl, ZBLOCK 3 
4003 
4020 
1200 
0100 
0000 



/HANDLER OPERATION ON UNIT 3 
/WRITE FROM FIELD 2 THE 
/BUFFER AT 1200 WHICH IS 
/lOO BYTES LONG 
/STATUS RETURN 



To read and not store 200 bytes from unit 2, the message is: 



MSG2, ZBLOCK 3 
4002 
0001 
0000 
0200 
0000 



/HANDLER OPERATION ON UNIT 2 
/READ AND DON'T STORE 
/UNUSED 
/200 BYTES 
/STATUS RETURN 



4.10.2 Utility Function 

The format of a message to the Cassette Handler when using a utility 
call is: 

ZBLOCK 3 
CALL+UNIT 
FUNCTION 
STATUS 



4-34 



RTS/8 SYSTEM TASKS 

For a utility function, the words after the RTS/8 message header are 
defined as follows: 



Word 1 



bit 0=0 
bit 0=1 
bits 9-11 



Word 2 (function in bits 6-8) 



Utility call 
Handler call 
Cassette unit 

10 = Rewind 

30 = Backspace file gap 

40 = Write file gap 

50 = Backspace block gap 

70 = Skip to file gap 



Word 3 Status return 



Function : 

1 Rewind 

3 Backspace file gap 

4 Write file gap 

5 Backspace block gap 
7 Skip to file gap 



10 



11 



Function Word Format - Utility Call 

For example, to request a rewind on unit 1, the message is; 
MSG3, 



ZBLOCK 3 
0001 
0010 
0000 



/UTILITY OPERATION ON UNIT 1 

/REWIND 

/STATUS RETURN 



If an error is encountered, the operation is retried 3 times, except 
when a write lock out is placed on a write operation or an error 
occurs while reading CRC. 

The CAPS-8 User's Manual {DEC-8E-0CASA-A-D) is suggested reading for 
users who are unsure of cassette conventions. 



4.11 CASSETTE FILE SUPPORT HANDLER 

The Cassette File Support Handler (CSAF) supports the DEC standard 
cassette format and allows the calling task to look up and enter files 
on cassettes in that format. This handler requires the cassette 
handler (CSA) to perform the actual I/O operations involved. 

The cassette operations ENTER, LOOKUP and CLOSE are performed by the 
Cassette File Support Handler (CSAF) which in turn calls the cassette 
handler (CSA). ENTER and LOOKUP require the user to put ' appropriate 
information in a record header area with which CSAF performs the file 
operations. The header area must be at least 40 (octal) words long and 
cannot cross field boundaries. 
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Word definitions for a CSAF message are as follows: 



Word 1 bit 0=1- ENTER 

bit 1=1- LOOKUP 

bit 2=1- CLOSE 

bits 9-11 - unit 



Word 2 



Word 3 



Address of header for ENTER and LOOKUP- 
status return for CLOSE 

Field of header for ENTER and LOOKUP fbits 
6-8) iuj.uto 



'^°^'^ ^ Status return for ENTER and LOOKUP 

In all cases, the status return is the contents of Status Register B. 





- 


1 


2 3 


4 


5 


6 


7 


8 9 


10 


1 ' 

J 



Function: , 

1 Close 

2 Lookup 
4 Enter 



Unit. 



Unit Word Format - Cassette File Support Handler 

For ENTER and LOOKUP, the format of the header area must conform with 

cassette standards (and therefore is compatible with CAPS-8) . This 

format is as follows: ' •^"■^'= 



Byte 
0-5 
6-10 
11 

12-13 

14-15 
16-23 

24-35 



Use 

Filename 

Filename extension 

File type 

1 = ASCII 

= undefined 

File record length. 
Currently word 12 must be 


Unused 

Date (ASCII) specified as 
ddramyy 

Unused 



Reference is to 8-bit bytes, one per word, riqht 
justified 

For an ENTER operation, if a file with the name specified in the 
header area is found on the specified unit, it is deleted. 
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For a LOOKUP operation, the record size of the specified file is 
returned in location header+13 (byte 13). If the file is not found or 
if an error occurs, this location contains 0. 

The CLOSE operation is automatically followed by a REWIND. 
Examples of messages follow. 



MSG4, 



MSG5, 



ZBLOCK 3 

4000 

6400 

0010 
0000 

ZBLOCK 3 

1003 

0000 



/ENTER ON UNIT 

/INFORMATION IN HEADER STARTING AT 

/6400 

/OF FIELD 1 

/STATUS RETURN 



/CLOSE ON UNIT 3 
/STATUS RETURN 



4.12 PDP-8A NULL TASK 

The PDP-8A Null Task counts from 1 to 9999 in decimal in the AC 
display. It also counts from 1 to 7777 in octal in the MQ display. 
The source which is called NULL8A, takes up a page. The user can 
configure the null task into an RTS/8 system by inclusion in the 
parameter file of its task name and the statement 

NULL8A = NTASKS+1 



4.13 KL8-A SUPPORT 

The KL8-A is a 4-serial line asynchronous multiplexer for the PDP-8/A 
that has three lines with partial modem control and one line with full 
modem control. KL8-A support is available to the RTS/8 Executive, the 
TTY task, and the OS/8 Support Task. To use KL8-A support, the user 
should perform the procedures that are described in the following 
sections. 



4.13.1 Executive KL8-A Support 

The symbol KL8A in the parameter file is set to a value equal to the 
number of KL8-A units being employed by the user. If one KL8-A is 
being used, then KL8A=1 is sp'^-if led . 

If the symbol 'KL8A' is set to or undefined in the parameter file, 
no KL8-A support will be provided by RTS/8. 

KL8-A support is provided by the RTS/8 Executive. The source file 
KL8ASR.PA must be assembled as follows: 

.PAL KL8ASR<PARAM,KL8ASR 



4-37 



RTS/8 SYSTEM TASKS 



The parameters in the parameter file that relate to KL8-A service 

as follows: 



are 



KL8A = or undefined 
= n 

KL8ADV = 



KL8ACT 



means that no KL8-A service is desired. 

means support for n physical lines is 
desired. Each physical KL8-A provides 
four lines. 

Device code for the first KL8-A. 
Default is 40. Each KL8-A uses two 
consecutive device codes {e.g., 40 and 
41). If multiple KL8-A's are used, they 
should have consecutive device codes. 

Specifies page for start of KL8-A 
connect routine. Default is 7400 (if 
KL8A = 1) . The KL8-A connect routine 
must be located in field 0. It is 
1-page long for one KL8-A and grows a 
page for every three additional KL8-A's 
used (or part thereof) . The default 
value of this parameter is such that the 
KL8-A support routine gets jammed up 
against the end of field 0, ending at 
location 15'^!. 



4.13.2 TTY Task KL8-A Support 

KL8-A support in the TTY task is initiated by setting symbol KL8A in 
the parameter file to nonzero. Then the KL8-A line to be used is 
specified in place of the terminal lOT device code plus 100. For 
example, if the TTY task is to control line 3 of a KL8-A, 

TTDEV = KL8ALINE+3 

is specified in the parameter file. (The symbol KL8ALINE is defined 
to have the value 100 in the parameter file.) If more than one KL8-A 
interface is used, the lines are numbered consecutively beginning with 
and continuing across interfaces. Thus, KL8-A logical line number 5 
actually is physical line number 1 of the second KL8-A interface. 
Physical lines are numbered from to 3. 

KL8-A support requires additional memory in field for Executive 
Support but does not increase the size of the TTY task. KL8-A support 
is included in both the old (2-page) and new (3-page) TTY task. 



4.13.3 KL8-A Support for the OS/8 Support Task 

KL8-A support for OS/8 is similar to that described for the TTY task. 
However, the following procedure is used. First, the symbol KL8A is 
set to nonzero in the parameter file. Then, the particular KL8-A line 
is specified by using a number of the form 100+line in place of the 
device code, where "line" is the line number of the KL8-A that is OS/8 
being used. The symbol KL8ALINE is conveniently defined as being 100 
in the parameter file. For OS/8 support, the parameter 



OSTTDV 



KL8ALINE+2 
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specifies that terminal output goes to line 2 of the KL8-A. When more 
than one KL8-A is used, the lines should be numbered successively as 
described for the TTY task support in Section 4.13.2. 



4.13.4 KL8-A Support for a User Task 

The KL8-A support in the Executive allows a user to program the KL8-A 
in a manner similar to the KL8-J. 

First, the user task must insert the KL8-A into the interrupt skip 
chain and provide a keyboard and printer interrupt routine to service 
the line he wishes to use. This is accomplished via the following 
code : 

CDF CUR 

CIF 

lOF 

TAD (LINE"4 

JMS I (KL8ACT 

KEYED INTERRUPT ROUTINE 

PRINTER INTERRUPT ROUTINE 

where LINE is the line number of the KL8-A desired, KL8-A line 
numbers are consecutive, begin at 0, and may span across KL8-As. The 
KL8-A line number is actually of the form 4a+b where a is the number 
of the KL8-A (0,1,2...) and b is the physical line number of the 
specific KL8-A (0-3) . 

Second, the user must define the instruction corresponding to the TLS 
instruction that will be used when outputting to the KL8-A line. 

For example, if the device code for the KL8-A is 40, then the user 
will probably want an instruction such as 

TLSX=6404 

in his task. 

Normally, a program would contain the following code to output a 
character : 

TAD char 
TLS 

When using a KL8-A, the task would first connect up the KL8-A support 
by calling KL8ACT. Then, to output a character, the following code 
would be used: 

TAD line "400 
TAD char 
TLSX 

The AC is not cleared by the TLSX. 



4.14 EXIT TASK 

The EXIT Task is not required for RTS/8 operation. If this task is 
included in a system, it is run by the MCR EXIT command. The EXIT 
task performs the same functions as those performed by the MCR EXIT 
command, that is, it waits for any pending operations to be completed, 
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then turns off interrupts and returns to the OS/8 operating system. 
In addition, the EXIT Task allows a user task to request additional 
special exit processing just prior to shutting down RTS/8. This is 
done by having the user task send a message to the EXIT Task. This 
message contains a single word. This word is the address of a routine 
(in the same field as the message) that will be called (via a JMS) at 
the time of the exit. When the MCR EXIT command is typed, these 
routines will be called and executed in the order that they were sent 
to the EXIT Task. 



NOTE 

Any message sent to the EXIT Task will 
not get posted. Also, do not use the 
MCR REquest command to run the EXIT 
Task. 
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CHAPTER 5 
MONITOR CONSOLE ROUTINE 



The Monitor Console Routine (MCR) provides functions that the user can 
request from the console terminal to control, inspect, and debug (to 
some extent) his system. 

The MCR indicates that it is active and ready to accept commands by 
printing the prompting character > on the system console terminal. An 
MCR command consists of a command word followed by arguments and 
terminated by either a carriage return or an ALTMODE. Only the first 
two characters of the command are significant except for the EXIT 
command. Commands can be a maximum of 40 characters long. If a 
carriage return terminates the command line, the MCR returns to the 
terminal for another command when it finishes processing the current 
command. If an ALTMODE terminates the command line, the MCR puts 
itself in a wait state when it finishes processing the command. The 
MCR is brought out of this wait state by typing "C (CTRL C) on the 
console terminal. 

When the MCR prompts with its > and is waiting for input, no other 
RTS/8 task can use the terminal. Therefore, if the terminal is used 
for something other than an exclusive MCR terminal (for instance, 
error logging) , type "C, type the MCR command and terminate it with an 
ALTMODE character. This procedure prevents the MCR from tying up the 
terminal . 



5.1 MCR COMMAND ARGUMENTS 

Certain syntactic constructions are used as arguments to several MCR 
commands. The definitions of these arguments follow. 

A single comma or a single space may be used 
interchangeably to separate arguments to MCR 
commands . 

Task-ID A Task-ID is either an octal number or a 
name. If it is a number, it represents the 
internal RTS/8 Task Number. This number also 
designates the priority of a task. If it is 
a name, the first 4 characters of the name 
are looked up in the MCR's Task Name table to 
produce a Task Number. 

Time-of-day A time-of-day is of the form hh:mm, where hh 
represents hours past midnight and mm 
represents minutes past hh:00. 

Address An Address is an octal number from 1 to 5 
digits that represents a PDP-8 memory 
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Word 



5.2 MCR COMMANDS 



address, if the address is less than five 
digits long it is assumed the high order 
digits are 0. 

A Word is an octal number from 1 to 4 digits 
long. 



of fL ^O™'^^"^ descriptions that follow, the significant portion 
of the command word is capitalized. Optional arguments are enclosed 

separated bv'T':^ "I- '"' -^'"^"^ ''' embedded in parentheses, 
?*?^ro 1^ L ^^^l^'!'!ti°" points (.). Commands preceded by asterisks 




5.2.1 * DAte [mm/dd/yyyy [ ,Time-of-day] ] 

The date mm/dd/yyyy, if specified, becomes the system date. For the 

n^hL/°'^'°" °^. ^^^ '^^^^' °"^^ ^^^ l^^t digit is significant; the 
others are ignored since 197 assumed. The RTS/8 system date is 
automatically incremented at midnight, but all months are treated as 
being 31 days m length. The second argument, if specified, is set 
equal to the system time-of-day. If no arguments are soecified, the 

""""V^T^n ^^^^^™ ^3te is printed on the console terminal in the form 
mm/dd/7y. 

>DATE 07/31/76 

>DATE 

07/31/76 



5.2.2 * Time [Time-of-day] 

If a Time-of-day command is specified, it becomes the system 

time-ot-day. if no argument is specified the current system 

time-of-day is printed out on the console terminal in the form hh:mm. 



>TIME 14:00 

>TIME 

14:00 



5.2.3 NAme Task-ID, Newname 



The character string Newname becomes the new name of the task if 
specified by this command. The old name of that task (if any) is 
lost. Newname can be any length, but only the first 4 characters are 
stored. Newname should not be the name of any other task or an error 
message results. ^lhjl 

Examples : 

>NAME 7 REPORT 

Task number 7 is given the name REPO. 
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>NAME REPORT, FOO 
Task number 7, which is known as REPO, is now known as FOO. 

NOTE 

The system initializes the MCR name 
table at assembly time to contain the 
names of any DEC-supplied tasks that are 
listed in the parameter file (e.g., if 
the symbol CLOCK is defined in the 
parameter file as CL0CK=2, task number 2 
gets the name CLCK) . By editing the 
file MCR. PA after the label NMTBL, user 
task names can be permanently included 
by modifying the MCR name table. 

5.2.4 REquest Task-ID [ , (@Time-of-day ! Interval) [, Interval] ] 

The REquest Task-ID command requests a task to run immediately (if 
only Task-ID is specified) , at a given time-of-day, after a given 
interval, or at a given interval. 

Interval is of the form: 



nH 


n 


hours 


nM 


n 


minutes 


nS 


n 


seconds 


nT 


n 


system ticks 



Requesting a task clears the RUNWT bit in the Task Flags Table entry 
for that task. The interval, given in the third argument, specifies 
the period at which the task is rerun. If the parameter CLOCK in the 
RTS/8 parameter file is not defined, the second and third arguments of 
this command are ignored and the given task runs immediately. In the 
examples given below, three different formats are used for the REquest 
command, but only the first two characters are significant except when 
using the EXIT command. 

Examples: 

>REQUEST X 
runs task X immediately. 

>RE FOO, (32:00 

runs task FOO at 2:00 am (if it is after 2 am, FOO will run tomorrow 
at 2 am) . 

>RE 5,10M,5M 

runs task number 5 ten minutes from now and every five minutes 
thereafter . 

>REQ HIPR,1T,6T 

On a machine with a 60 Hz clock, this command runs the task HIPR 
immediately (that is, .016 seconds from now, and 10 times per second 
thereafter) . 
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NOTE 

If, at the time the REquest command is 
executed, (which may be several hours 
after it is typed in) the task specified 
by Task-ID does not have the RUNWT bit 
set in its Task Flags Table entry, then 
the REquest command is a no-op (no 
operation), that is, the command has no 
effect. Similarly, the task will not 
run upon execution of the REquest 
command if it had other bits set beside 
RUNWT; the task will run only when the 
other blocking bits are cleared. 



5.2.5 STop Task-ID 

The STop Task-ID command suspends execution of the task specified by 
Task-ID by turning the RUNWT bit on in the Task Flags Table entry for 
that task. A task that has been stopped can be restarted by using the 
REquest MCR command (in this instance it is easier to think of it as 
the REsume MCR command) . 



5.2.6 Disable Task-ID 

The Disable Task-ID command disables future execution of the specified 
task by setting the ENABWT bit on in the Task Flags Table entry for 
that task. 



5.2.7 ENable Task-ID 

The ENable Task-ID command clears the ENABWT bit in the Task Flags 
Table entry for the specified task, thus enabling it to run. If the 
ENABWT bit was not set, the command is a no-op. 



5.2.8 * CAncel Task-ID 

The CAncel Task-ID command cancels any clock queue entries involving 
the task specified by Task-ID. This includes l)any entries made by 
the MCR (from previous timed Request commands), 2)entries involving 
the specified task made by other tasks (e.g., a timed DERAIL) and 
3)entries made by the specified task involving itself (e.g., a timed 
POST). In the case of the timed POST, the event flag is not POSTed 
and the task may hang up forever waiting for it. 



5.2.9 SYstat [Task-ID] 

The SYstat command, depending on whether an argument is specified, 
prints either a general system status report or a status report in 
greater detail on a single task. If no argument is specified, the 
SYstat command prints a system status report. Each line of the report 
describes an existent task in the system. For each task the report 
prints the task number/priority, task name (if it has one), and what 
blocking bits are on in its Task Flags Table entry. Each blocking bit 
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is printed as a one-letter code, preceded by a space. The one letter 
codes and their meanings are: 

E Waiting for event flag 

M Waiting for a message 

Waiting for an event flag or a message 

R Waiting to be REquested or RUN 

S Waiting to be swapped in 

D Disabled 

U USERWT bit set 

N Nonresident wait 

In addition, an asterisk printed at the end of the line means the task 
has messages waiting in its input queue. 

A more detailed status report on a single task is obtained by 
specifying the Task-ID of that task as an argument to the SYstat 
command. The detailed report contains all the information in the 
general status report, followed by five octal words: 

WORD 1 The location of the Task State Table 

entry containing words 2-5; this 

word is followed by a colon 
WORD 2 Task Link in sign bit, IF in bits 6-8, 

DP in bits 9-11 (PDP-8/E and 8/A Flags 

Register) 
WORD 3 Task PC 
WORD 4 Task AC 
WORD 5 Task MQ 

Examples : 

A general SYstat command might produce the following sample output 
line: 

13 CARD E * 

This line means task number 13, named CARD, is in Event Flag Wait and 
has input messages pending. The command: 

>SYSTAT CARD 

might produce the single line: 

13 CARD E * 1320: 0022 1741 0000 2525 

This line indicates that CARD is stopped at location 21741 with its AC 
and Link zero and 2525 in its MQ. 

The user can leave the SYstat facility out of the MCR assembly by 
setting the system parameter MCRSYS to in the RTS/8 parameter file. 
Leaving it out saves one page of code. 



5.2.10 OPen Address [, Count] 

The OPen Address command displays the Count locations in octal 
starting at Address on the console terminal in the form: 

11111/ cccc 

The range of locations displayed may cross a field boundary. If Count 
is not specified, it is assumed to be 1. 
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CHAPTER 6 
ASSEMBLING AND LOADING TASKS FOR RTS/8 



The user assembles RTS/8 tasks with parameter files, using the OS/8 
PALS assembler. RTS/8 parameter files are all edited versions of a 
master parameter file (PARAM.PA) that is included in the distributed 
sources. Appendix A lists the RTS/8 source files. All definitions in 
the master file which are to be supplied by the user are left blank in 
the file. For example, a sample line in the file is: 

PDP8E= /I IF POP 8/E OR POP 8/A, ELSE 

If this parameter is set to 1, the specified machine is a PDP-8/E or a 
PDP-8/A. If either machine is not used, this parameter is set to 0. 

Thus, a unique parameter file is created for the particular RTS/8 
environment, where environment is a combination of the available 
hardware and the set of tasks being run. 

The structure of the parameter file is discussed in the next section. 
Other sections in this chapter describe 1) the OS/8 BITMAP program 
which allows the user to construct a map showing the memory locations 
used by given binary files, 2) a sample RTS/8 program 3) a general 
procedure for creating an RTS/8 system, and 4) a listing of parameters 
and their functions that affect the individual RTS/8 system tasks. 



6.1 PARAMETER FILE STRUCTURE 

The parameter file contains the parameters that the user must define 
to specify a particular RTS/8 system configuration. A parameter file 
that has been modified for the demonstration program is shown in 
Section 8.1. This file also contains user-defined symbols for 
DECNET/8. For further information on DECNET/8, see RTS/8 DECNET/8 
Programmer's Guide and Reference Manual (DEC-08-LDPRA-A-D) , 

The parameter file is divided into the following five sections. These 
sections are labeled as follows: 

1. Executive Specifications 

2. Task Definitions 

3. System Task Specifications 

4. System Wide Definitions 

5. Task Setup 
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6.1.1 Executive Specifications 

The parameters in the Executive Specification section control the 
assembly of the Executive, and therefore are essential to the RTS/8 
system. The parameters in this section and their meaning are as 
follows: 



Symbol 
PDP8E 



Meaning 



Set to 1 if PDP-8/E, PDP-8F, PDP-8M or PDP-8/A is 
the machine being used; if not, this symbol must 
be set to 0. 



PDP12 



EAE 



PWRFAL 



Set to 1 if PDP12 is the machine being used; if 
or undefined, the PDP-12 is not being used. 

Set to 1 if the system should save contents of the 
MQ during an interrupt or task switching. 

Set to 1 if power fail/restart is enabled in the 
hardware . 



KL8A 



HGHFLD 



NTASKS 



CHECKP 



Set to a nonzero if KL8-A support routines should 
be loaded into system. 

Set to a value designating the highest field used; 
for example, HGHFLD = 30 specifies field 3 when 
using a machine with 16K core memory. 

Set to an octal value that specifies the total 
possible number of tasks in the system. It also 
represents the highest number that can be assigned 
to any task in the system. Not all possible task 
numbers need be assigned to actual tasks; this 
symbol merely sets the length of system tables. 



Set to 1 if 
checkpointable . 



any nonresident task 



IS 



PARTNS 



Set to the number of memory partitions allocated 
in the system. Set to zero if there are no memory 
partitions defined in the system. For example, 
PARTNS = 2 indicates that there are two memory 
partitions defined, that is, partition number 
and partition number 1. 



6.1.2 Task Definitions 



The Task Definitions sectio 
system tasks. The names o 
in the system are defined h 
have the line which def 
this deletion by inserting 
the line, which makes the e 
of the user's own tasks can 
reminded that the assignm 
priority, that is, the lowe 
the task. 



n defines symbolic names for the 
f all system tasks which are to be 
ere. Any system task not included 
ines it deleted from this section, 
a slash (/) character at the begin 
ntire line a comment. Symbolic def 

be added to this section. The 
ent of task numbers in octal indica 
r the number, the higher the prio 



various 

included 

should 

Perform 
ning of 
initions 
user is 
tes task 
rity of 
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The Task Definitions section, 
shown below. 



as it initially appears to the user, is 



/COMMON TASK NUMBERS - EDITED BY USER 

/IT IS ADVISABLE TO DEFINE ALL TASKS HERE. NAMES GIVEN BELOW 
/ARE USED BY SOME SYSTEM TASKS AND SHOULD REMAIN COMMENTED OUT 
/IF THE CORRESPONDING TASK IS NOT INCLUDED IN THE SYSTEM 



/PWRF= 

/CLOCK= 

/SWAPPER= 

/TTY= 

/LPT= 

/MCR= 

/DTA= 

/LTA = 

/RK8 = 

/RF08= 

/DF32= 

/CSA= 

/CSAF= 

/UDC = 

/RX8A= 

/RX8B= 

/RX8C= 

/RX8D= 

/0S8 = 

/0S8F= 

/DDCMP= 

/NSP= 

/NIP= 

/TLK= 

/LSN= 

/NULL8A 

/EXIT= 

/DKC8A= 



NTASKS 



/POWER FAIL HANDLING TASK 

/CLOCK HANDLER - SHOULD BE HIGH PRIORITY 

/NONRESIDENT TASK SWAPPER TASK 

/TELETYPE DRIVER TASK 

/LINE PRINTER DRIVER TASK 

/MONITOR CONSOLE ROUTINE 

/DECTAPE DRIVER TASK 

/LINCTAPE DRIVER TASK 

/RK8 OR RK8E DISK DRIVER TASK 

/RF08 DISK DRIVER TASK 

/DF32 DISK DRIVER TASK 

/CASSETTE DRIVER TASK 

/CASSETTE FILE SUPPORT TASK 

/UNIVERSAL DIGITAL CONTROLLER TASK 

/FIRST FLOPPY CONTROLLER 

/SECOND FLOPPY CONTROLLER 

/THIRD FLOPPY CONTROLLER 

/FOURTH FLOPPY CONTROLLER 

/OS/8 SUPPORT - NORMALLY LOWEST PRIORITY 

/OS/8 FILE SUPPORT 

/DDCMP TASK FOR DECNET 

/NETWORK SERVICES PROTOCOL TASK 

/NETWORK INFORMATION PROGRAM 

/NETWORK TERMINAL COMMUNICATIONS TASK TRANSMITTER 

/NETWORK TERMINAL COMMUNICATIONS TASK RECEIVER 

/NULL JOB FOR PDP-8/A 

/EXIT TASK 

/AUXILIARY DKC8A HANDLER 



This section of the parameter file is shown in Section 8.1 after it 
has been modified for the demonstration program. It also shows the 
addition of the two nonresident tasks used in the demonstration 
program. 



6.1.3 System Task Specifications 

The parameters in the System Task Specifications section control the 
assemblies of the various RTS/8 system tasks. The set of parameters 
controlling a specific task are all grouped together and assembled 
conditionally only if that task name is defined in the Task 
Definitions section of the parameter file. The user edits the 
parameters in this section. The parameters and their meanings are 
listed in Section 6.4. 



6.1.4 System Wide Definitions 

The System Wide Definitions section includes the 



definitions of the 



symbols that RTS/8 uses to describe Executive Requests and Task Status 
Flag bits. It also contains useful definitions such as instruction 



equivalences , 
system locations 



monitor call values, UDC/ICS functional 
The user should not alter this section. 



values and 
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6.1.5 Task Setup 

kJI^/^^f Setup section uses five symbols that the user defines in the 
?°f^ .°L''?'%^^'' '° initialize the RTS/8 table entries needed ?o put 
that task m the system. These five symbols and their definitions 



TASK 



Defines the task number of the task by a statement 
of the form: 



CUR 



TASK=symbol 

where "symbol" is the symbolic name for the task 
that the user has defined in the RTS/8 parameter 
file. 

Defines the field of the task's starting address 
in bits 6-8 (e.g., CUR=10) . 



NOTE 

The user must place the task's starting 
code in the field specified by CUR. This 
is done by using the PAL8 assembler 
pseudo-op FIELD. 



For example, FIELD CUR%10 places 
task's starting code in field 1. 



the 



START 



INIWT 



Defines the task's starting address 
necessarily the lowest address in the task) 



(not 



Defines the initial wait b 
Table entry for this task, 
means the task is runnable 
up; INIWT = RUNWT (1000 
this task is not runnable 
Run Wait condition. Th 
when another task issues a 
operator types a Request 
INIWT is undefined, the 
runnable. 



its in the Task Flags 

For example, INIWT = 

when the system starts 

octal) specifies that 

initially and is in a 

is task becomes runnable 

RUN ER or when the 

command to the MCR. If 

task starts up being 



VERS 



Defines the task's version number, this is an 
optional parameter. By convention, the task's 
version number becomes the task's initial MQ 

value . 



The user can define 

Lng 
and CUR3, etc 



"P to three tasks in one assembly. The 
^^^^rno^^ ^^^ ^lu^°^^ ^°^ ^^^ °t'^^'^ <^3sks are TASK2 and TASK3, CUR2 
and CUR3, etc. The task setup section places its data into the RTS/8 
tables by originmg into them; no executable code is generated If 
desired, more than three tasks can be created in one assemhlv by 



Z^y^r^r. \v. T '!"•-'="= ^°="^^_^<i'^ oe createa m one assembly by 

fut^ tI L ""^^^ fo>^ any additional tasks at the end of the PARAM.PA 
file. It should be noted that only one task is defined in the 
demonstration program in Chapter 8. 
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6.2 CREATING AN RTS/8 SYSTEM 

An RTS/8 System can be created by using the general procedure that is 
described in this section. It is assumed that the user has physically 
mounted a copy of the distribution medium, and has bootstrapped tne 
development system. Although nonresident tasks are treated in this 
procedure, greater detail on employing nonresident tasks is given in 
Chapter 7. 

The general procedure for creating an RTS/8 System is as follows: 

1. Layout on paper the system and user tasks required for the 
particular RTS/8 configuration to be employed. Utilize the 
tables and memory map given in Appendix B that show the RTS/B 
components, their sizes, and their default origins to 
determine where the tasks are to be loaded into memory. 

2. Assign task names and task priorities. If nonresident tasks 
are used, assign the Swapper Task a higher priority than any 
of the nonresident tasks. Remember that the lower the value 
assigned to a task, the higher its priority. 

3. When large programs are involved, a documentation file should 
be created as a user convenience to maintain a directory of 
the system configuration. This file can contain information 
such as the tasks employed in the system, task names, task 
priorities, and control files. 

4. Obtain a listing of the master parameter file (PARAM.PA). 
Use the OS/8 command 

.LIST PARAM.PA 

to get a listing from a line printer, or 

.TYPE PARAM.PA 
to get a listing from a terminal. 

5. Use an editor (EDIT or TECO under OS/8) to establish the 
values of the parameters in the parameter file (PARAM.PA). 
The structure of the parameter file is described in Section 
6.1, and the parameters affecting the individual RTS/8 system 
tasks are described in Section 6.6. 

PARAM.PA should be read in as an input file, edited, and then 
renamed as an output file. This procedure maintains the 
integrity of DIGITAL-supplied sources. 

6. Create and edit any control files that are used (See Section 
6.5) . 

7. Assemble the tasks with the parameter file after all the 
required parameters are defined. This can be accomplished by 
individually assembling each task with the parameter file as 
follows : 

.PAL RTS8<PARAM,RTS8 

or 

.PAL PARAM-NB, RTS8 
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orL^^!^ °^o^°" "''^ indicates that a binary file should not be 
h^!^ : Shown IS the assembly of the RTS/8 Executive. This 
F^^h ^^^ r. ?" ^""^"^ ^^^^ ^^""^ is included in the system. 
!f^l^...?°?^:^°l f^l^.^s^d must also be assembled. Assemble the 

the control 
ed module as 



control file with the parameter file, olacing 
file between the parameter file and the requir 
follows: ^ 



.PAL TTY1<PARAM,TTYCF1,TTY 

An alternate and more efficient method that can be employed 
is to use a Batch stream. The assembly, load and save 

SsT^srmM?^ ''" '^''""' "r ^^"^^-ted as a Batch job. ?he 
OS/8 SUBMIT command is then used to run BATCH which will use 
the Batch :ob commands as inputs and execute them. This 
?he sjstem. ° ""^ ""^^^ '°" installing nonresident tasks into 

The assembly of each task, preceded by the parameter file, is 

R?I/r Th''""'\i''"^ '' no linking loader function ^ith 
Kifa/8. The assembly process creates binary files from the 
sources that are ready to be loaded and run. Each RTS/8 
system task contains assembler code that assembles it for 
loading into a specific area of core memory. The user can 
assemble tasks to load into areas of memory not used by 

^o^^??,' '''''' °' "'J.' '^" ^^^t^-" ^^^^^ f°^ loading into 
specific areas. Page locations and autoindex registers 

ff *- I ^sy^tem tasks can also be redefined by editing the 

8. Obtain a bitmap of RTS/8 tasks to determine if two or more 
tasks are erroneously loaded into the same memory area or use 
the same page locations (See section 6.3). 

9. Load the system after all the required tasks are assembled. 
All required system tasks, user tasks, and control files can 
be loaded at one time as follows: 

.LOAD RTSS, CLOCK, TTY,MCR,UT1,UT2 

The RTS/8 Executive Task always must be loaded first. Also, 
nonresident tasks are included in this step in order to load 
their resident portions and executive table entries. 

^°" command^ system after it is loaded by using the following 
.SAVE SYS filename 

If the system is saved, the user does not have to rebuild it 
each time it is needed. 



When using nonresident tasks, create a SAVE imaqe file 
(nonresident disk image) for each nonresident task from its 
binary file as follows: 

.LOAD TASKX 

Then save the nonresident portion of the task on the swap 
device: ^ 

.SAVE DSK TASKX N1-N2 

Where pSK is the swap device, Nl is the lowest address in the 
partition, and N2 is the highest address in the partition. 
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12. Start the system by using the following command: 
•R filename 

The following is applicable when using nonresident tasks. 
When the system starts, it calls the OS/8 command decoder, 
which types an asterisk on the console terminal. At this 
time, initialize the block address of each nonresident task 
core image as follows: 

*DSK:TASKX=N 

In this command line, DSK is the swap device and TASKX is the 
core image file containing the nonresident portion of task N. 
Repeat this procedure for each nonresident task, one task per 
line, and terminate the last line with an ALTMODE. This 
procedure automatically initializes and starts the real time 
system. 

An RTS/8 system created with the procedure just described has 
a starting address of 00200. If an RTS/8 system was not 
specifically configured for a PDP-8/E or PDP-12, it halts 
initially to allow the operator to clear any stray device 
flags by operating nonstandard hardware switches or by 
pressing START. Press START to resume operation on a PDP-8, 
8/1 or 8/L. 



6.3 USING THE OS/8 BITMAP PROGRAM 

The OS/8 BITMAP program can be extremely useful in determining that no 
two RTS/8 tasks are loading into the same area or using the same Page 
locations. OS/8 BITMAP accepts a list of binary files as input and 
produces as its output a map of core memory. Each location of core 
memory is represented in this map by a single digit which has the 
following meaning: 

Nothing has been loaded into this location 

1 Information has been loaded into this location 

2 Information has been loaded into this location twice 

3 Information has been loaded into this location three or more 
times 

There are certain places in core memory where 2's are allowed to 
appear in the bit map. These areas are the RTS/8 Executive Tables 
(starting at location 01200) , the MCR name table in the MCR, the power 
fail action table, and nonresident task partitions (which may contain 
2's and 3's). Appearance of a 3 or a 2 in an area other than these 
three areas just mentioned in the bit map indicates that two or more 
tasks are being loading into the same location. 



6.4 SAMPLE RTS/8 TASK PROGRAM 

The task that is used as an example in this section was selected for 
its simplicity, and to show the basic concepts of RTS/8 operation. 
The purpose of the task is simply to print "HELLO". The user requires 
an RTS/8 system configuration that includes a console Terminal Handler 
(TTY) and the Monitor Console Routine (MCR) . It is assumed that the 
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tasK will be running on a PDP-8 E/F/M/A with 8K of core raemory and a 
standard console terminal. 

The program (SAMPLE. PA) listed below is complete, and when assembled 
"^^ the parameter file, will run as task 5 in a properly-configured 
system. The task is initially in the Run Wait state. When requested 
^.l.T^nf. ""^tl through the Monitor Console Routine, the task prints 
HELLO on the console terminal, and then suspends itself. If aqain 
requested by the user, the same sequence will occur. 

/SAMPLE RTS/8 PROGRAM 

TASK=5 /GIVEN A PRIORITY OF 5 

CUR=0 /IN FIELD 

INIWT=RUNWT /SET TO RUN WAIT STATE 

FIELD /PLACED IN FIELD 

*3000 /ANY AVAILABLE PAGE 
START, CAL 

SENDW /MUST BE DEFINED AS "START" 

TTY /SEND AND WAIT 

MSGl /THE TERMINAL 

CAL /THE MESSAGE BLOCK 

SUSPND /SUSPEND THE TASK 

JMP START /RESUMES HERE IF REQUESTED 

MSGl, ZBLOCK 3 /RTS/8 LINKAGE 

0;0 /TERMINAL OPTIONS 

TEXT /HELLO/ /TYPE HELLO 

$ 

An edited version of PARAM.PA now is required for this configuration, 
and it IS named PARAMS.PA. To produce PARAMS.PA from PARAM.PA, the 
following definitions are edited into the parameter file: 

PDP8E=1 

HGHFLD=10 

NTASKS=10 

TTY=4 

MCR=3 

NTASKS is the largest task number used with this system. It is 
assigned any number greater than the values for MCR, TTY and the 
sample task, and which is smaller than 100 octal. The task values for 
SAMPLE, MCR and TTY were arbitrarily chosen in the range greater than 
zero and less than NTASKS. 

The program is then assembled as follows: 

.R PAL8 

♦SAMPLE . BN<PARAMS . PA , SAMPLE . PA 

The system for the sample task requires the Executive Task RTS8 plus 
the TTY and MCR Task to run. This can be accomplished by using the 
following Batch stream: 

$JOB 

.PAL PARAMS-NB,RTS8 

.PAL PARAMS-NB,MCR 

.PAL PARAMS-NB,TTY 

.PAL PARAMS-NB, SAMPLE 

.LOAD RTS 8, MCR, TTY, SAMPLE 

.SAVE SYS: SAMP 

$END 
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Assembly and loading of the tasks, including saving the program, is 
now complete. The CCL option -NB indicates that PARAM is not to be 
used as the name of the binary file being created. 

The system now can be run as follows (user input is underlined) : 



. R SAMP 
> RE 5($) 
HELLO 
IC 
> SYSTAT 

03 MCR 

04 TTY 
05 

> RE 5($) 
HELLO 

ic 

>EXIT 



/OS/ 8 RUN COMMAND 

/REQUEST SAMPLE FROM MCR 

/TASK EXECUTES AND SAYS 'HELLO' 

/RETURNS CONTROL TO MCR 

/SYSTEM STATUS COMMAND 

/MCR TASK 

/TERMINAL TASK 

/TASK 5 WAITING TO BE RUN 

/RUN TASK AGAIN 

/TASK SAYS 'HELLO' AGAIN 

/RETURN CONTROL TO MCR 

/RETURN TO OS/8 

/OS/8 MONITOR 



NOTE 

($) is the ALTMODE character; all other 
input lines are terminated by a Carriage 
Return. 



6.5 USE OF CONTROL FILES UNDER RTS/8 

There are times when a user may want to assemble a given source module 
in more than one way and use the results under RTS/8. For example, 
suppose there are three terminals that a user wants to service under 
RTS/8. Each terminal has its own characteristics, and each copy of 
the TTY task needs to have its own set of parameters. The user must 
load three copies of the TTY task into memory at different locations, 
and possibly in different fields. This cannot be accomplished 
efficiently when using a single parameter file. With a single 
parameter file, three copies of the file TTY. PA must be made and each 
one edited to produce three individual tailored copies of the TTY 
task. This procedure is not convenient or modular. 

A better way to do this is to use a control file that contains all the 
equates necessary to define the parameters needed by a particular TTY 
task. The control file then is assembled together with and placed 
between the parameter file and the TTY module. For example. 



.PAL TTYl < PARAM, TTYCFl, TTY 

creates a binary file called TTYl from TTY. PA 
called TTYCFl. 



using 



control file 



To facilitate using this procedure, a skeleton TTY control file is 
supplied with the RTS/8 task sources. It contains all the parameters 
that the user normally defines in the parameter file. Thus, a user 
who wants to use multiple terminals, instead of editing the parameters 
in the parameter file, can create a control file for each terminal 
that is used, and then edit the control file to make multiple copies 
as necessary. 

An example of a TTY Control file after it has been edited by a user is 
shown below. 
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TASK=TTY1 


/ 


TTDEV= 


/ 


KBDEV= 




C0NS0L=1 


/ 


VT50= 




SC0PE=1 


/ 


FILL= 


/ 


WIDTH= 


/ 


TAB = 




OLDTTY=0 


/ 


LSBOT= 




TTFLD=20 




TTLOC=3000 



/DEFAULT IS 'TTY' 

/PRINTER DEVICE CODE - DEFAULT IS 04 

/KEYBOARD DEVICE CODE - DEFAULT IS TTDEV-1 

/I ENABLES CTRL/S AND CTRL/Q 

/NUMBER OF FILL CHARACTERS, I.E. 4 

/TTY LINE WIDTH (0 MEANS INFINITE), DEFAULT 

/I IF TTY HAS HARDWARE TABS 

/I LISTS BOTH HANDLERS (DEFAULT 0) 



l^l^ l^^^ Shows a TTY control file that has been edited for task 

TTYl. This terminal handler task will be assembled for the console 
terminal. Setting SC0PE=1 causes RUBOUT to move the cursor left one 
position, physically removing the character from the screen. The new 
tnree-page handler is specified. It is placed in field 2, starting at 



A skeleton control file is also supplied for the RXOl floppy, 
can easily generate and use control files for other purposes. 



Users 



6.6 RTS/8 SYSTEM TASK PARAMETERS 

This section provides a convenient grouping of those parameters which 
affect the individual RTS/8 system tasks. Given for each system task 
IS the parameter, its function and where applicable, an example. The 
section or chapter where a detailed description of the task appears in 
the text of this manual is noted after the task subhead. 



6.6.1 Clock Handler Parameters (Section 4.1) 



PARAMETER 



MEANING 



CLKTYP 



Specifies selection of hardware clocks as folio 

= DK8-EA/DK8-EC 

1 = KW12 

2 = PDP-8/A 

3 = DK8-EP 



ws ; 



CLKQLN 



Specifies minimum number of entry slots 
clock queue (default is 20) . 



in 



the 



HERTZ 



SHERTZ 



Specifies number of hardware ticks per second. 
HERTZ and SHERTZ are decimal values in that they 
are preceded in the parameter file by the 
pseudo-operator DECIMAL. 

Specifies the number of system ticks per second. 
This parameter is followed by the pseudo-operator 
OCTAL, which resets the radix to its original 
octal base. 
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6.6.2 Swapper Parameters (Section 7.4) 
SYS 



SUNIT 



Specifies the swap driver task; for example, 

SYS = RK8 specifies the RK8 driver task. 

Specifies the swap device physical drive unit; 
SUNIT = selects RKAO. 



6.6.3 Terminal Handler Parameters (Section 4.2) 

PARAMETER MEANING 



TTDEV 



KBDEV 



Is set to the proper printer device code; default 
value is 4. 

Is set to the proper keyboard device code; 
default value is TTDEV-1. 



The following parameters are available to the user to facilitate the 
use of the TTY task. 



VT50 



CONSOL 



WIDTH 



SCOPE 



TAB 



Is set to 1 (default) to enable CTRL/S and CTRL/Q 
functions. When set to 0, CTRL/S and CTRL/Q are 
not treated as special characters. Typing CTRL/S 
while data is being printed/displayed on the 
screen stops the data presentation until the next 
CTRL/Q is typed. This parameter must be set to 1 
if the user's terminal is a VT50 or VT52. Both 
CTRL/S and CTRL/Q turn off the echo flag. 

Is set to 1 to specify that the handler is being 

assembled for the console TTY (default) . Set to 

to specify that this handler should not wake up 
the MCR when "C is typed. 

Is set to an octal number that specifies the TTY 
page width. TTY width is currently set to 120 
(octal) , that is, a page width of 80 decimal 
characters. WIDTH = 60 sets the TTY page width to 
48 decimal characters. 

This option is used to determine the treatment of 
the RUBOUT key as follows: 

SCOPE=0 (default) provides the normal mode of 
RUBOUT support. 

SC0PE=1 causes RUBOUT to move the cursor left one 
position, physically removing the character from 
the screen. If the cursor is in column 1, RUBOUT 
still works, but has no visible effect. 

This option simulates tabs by the proper number of 
spaces. This is accomplished via the assembly 
parameter TAB as follows: 

TAB=0 (default) specifies that the hardware does 
not support tabs. The software simulates tabs by 
spaces • 

TAB=1 specifies that the hardware does support 
tabs. 
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Fill Characters are supported via the assembly 
parameter FILL as follows: 

FILL=0 (default) does not provide any fill 
characters . 

FILL=n sends n fill characters (nulls) after a 
line feed; n must be in the range 1-5. FILL=4 is 
recommended for 2400 baud VT5's. 

Is set to 1 to specify the use of the old 2-page 
TTY handler. Set to (default) to use the 
standard 3-page handler. The old handler has 
fewer features, but it is a page shorter. The 
parameters VT50, WIDTH, SCOPE, TAB and FILL have 
no effect when using the old handler. 

Is set to 1 to list both the old 2-page and new 
3-page handler. Set to (default) when only the 
handler selected by OLDTTY is to be listed. 

Is set to specify the field of TTY Task; for 
example, 20 specifies field 2. 

Is set to specify the location of TTY Task; for 
example, 3000 specifies a starting location of 
3000. 



Several equates are 
sending messages to 

NOPACK=4000 

NOCRLF=2000 

IND=1000 

NOLINE=400 
ASSGN=200 



listed in the parameter file. They are useful for 
TTY or LPT Tasks. These equates follow: 

Used if the output message is not 6-bit ASCII. 

Used if the output message should not be followed 
by carriage return/line feed. 

Used if OUTTXT points to the first word of the 
output text. 

Used if the output is in character mode. 

Used to assign the device handler for use by only 
this task. 



KL8ALINE=100 Used with KL8-A support (see Section 4.13.2) 

6.6.4 Monitor Console Routine Parameters (Chapter 5) 

PARAMETER MEANING 



MCRSYS 



MCRCLK 



MCRFLD 



Is set to 1 if the SYSTAT facility is desired for 
printing system status reports of existent system 
tasks. 



Is set to if the clock functions are not 
by the user. 



wanted 



Is set to the field in 
locate MCR. MCRFLD = 
3. 



which it is desired to 
30 places the MCR in field 
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MCRPRT 



MCRORG 



MCRCDV 



Is set to the number of the partition into which 
the nonresident portion of the MCR will be 
swapped. This parameter makes 
nonresident; however, 
is always resident. 



the MCR 
the first page of the MCR 



Is set to specify the starting location of the 
MCR. Default causes the MCR to load against the 
end of the field. 



Set to task name of task which is to be 
console device. Default is TTY. 



the MCR 



6.6.5 OS/8 Support Task Parameters (Section 4.6) 

PARAMETER MEANING 



OSFLDS 



OSKBDV 



OSTTDV 



OSSYSD 



OSFILL 



Is set to the number of fields allocated for OS/8. 
OSFLDS = 2 specifies two fields or 8K of memory 
for OS/8. 

Is set to the device code that selects desired 
OS/8 keyboard terminal. OSKBDV = 03 specifies the 
use of the console terminal keyboard for OS/8. 
Note: OS/8 requires its own dedicated terminal. 

Is set to the device code which selects desired 
OS/8 teleprinter. OSTTDV = 04 specifies the use 
of the console teleprinter for OS/8. 

Is set to select the OS/8 system device driver 
task. OSSYSD = DTA specifies DTAO as the OS/8 
system device. 

Is set to the number of null characters that must 
follow a line feed character on the OS/8 terminal. 
OSFILL = 4 is specified when using a 2400-baud 
VT05 terminal. Set to when using standard 
hard-copy terminals. 



Note: A terminal device handler does not have 
be included for the OS/8 terminal device. 



to 



6.6.6 KL8-A Support Parameters (Section 4.13) 

PARAMETER MEANING 



KL8ADV 



KL8ACT 



Specifies the device code for the first KL8-A. 
Default is 40. If multiple KL8-A's are used, they 
should have consecutive device codes. 

Specifies the page for the KL8-A connect routine. 
Default is 7400 (if KL8A=1) . The KL8-A connect 
routine must be located in field 0. 
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6.6.7 Line Printer Handler Parameters (Section 4.3) 

PARAMETER MEANING 

LPTLOC Specifies the starting location of the Line 
Printer Handler Task. 

LPTFLD Specifies the field of the Line Printer Task. 



6.6.8 DECtape Handler Parameters (Section 4.4) 

PARAMETER MEANING 

DTALOC Specifies the starting location of the DECtape 

Handler Task. 

DTAFLD Specifies the field of the DECtape Handler Task. 



6.6.9 EXIT Task (Section 4.14) 

PARAMETER MEANING 

EXITFLD Specifies the field of the EXIT Task. 

EXITLOC Specifies the starting location of the EXIT Task, 
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CHAPTER 7 
NONRESIDENT TASKS 



7.1 OVERVIEW 

A nonresident task is a task or a portion of a task that resides on a 
mass storage device during the time the task is not runnable. The 
mass storage device is called the swap device. It can be any mass 
storage medium (e.g., an RK8 cartridge disk or an RX8 floppy disk). 
When a nonresident task becomes executable, the Executive posts a 
residency request. The Executive then runs a special task called the 
Swapper to load the nonresident or portion of the nonresident task 
into memory. The loading process is called a swap. The memory area 
into which or out of which the nonresident task is swapped is called a 
partition. A partition is a contiguous block of memory that is used 
for task execution; it is readable in a single mass storage call. 
The use of nonresident tasks permits several tasks to share the same 
areas of memory, optimizing the use of available memory. 

Tasks can be either totally or partially nonresident. Very few tasks 
are totally nonresident; in most applications, the nonresident 
portion includes all, or nearly all, of the active locations. Active 
locations are those that contain executable instructions or data that 
are never accessed by other tasks. The resident portion of a task 
includes messages, event flags, buffers and similar passive registers 
that may be needed by other tasks. 
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single memory field 




c) Length has to be an integral 




number of pages 




d) Cannot overlap another partition 







Figure 7-1 Nonresident Task Implementation 



The process that swaps the nonresident portion of a task into memory 
is similar to the overlay capability found in OS/8 FORTRAN IV and 
related programs. However, swapping is much more powerful than 
overlaying. Every nonresident task has two properties that establish 
when and how it is swapped into or out of memory. These two 
properties are "wr iteability" and "checkpointability" . 

A task is made "writeable" if its nonresident portion must be written 
onto the swap device whenever it is swapped out to make room for 
another task. A writeable task is any task that is 
self-modifying - i.e., the task's code is changeable during task 
execution, and any task that must initialize before it can start. The 
writeability feature guarantees that the nonresident portion of a task 
is always up to date by refreshing the swap device image of the 
nonresident portion whenever the task is swapped out of memory. 



A task is made "checkpointable" if it may be swapped out of memory 
automatically, without its consent, to make room for a higher priority 
task. A task that was checkpointed and swapped out of memory is 
swapped back automatically as soon as all higher priority tasks have 
relinquished the necessary memory space. Execution then continues at 
the point where it was interrupted, and the task is not aware that it 
was interrupted. 
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Some nonresident tasks have both writeable and checkpointable 
characteristics. Writeable tasks are utilized when a task must modify 
itself (for example, it includes JMS instructions or temporary 
locations). Tasks suitable for checkpointing are those that are 
1) fairly long-running, and 2) are required only occasionally. 



7.1.1 Writeable Tasks 

A writeable task is one that includes code that is self-modifying, or 
code that must be initialized before execution. Before pxecution 
begins, all nonresident tasks must reside as core image file'5 jn the 
swap device. The core images are created by loading each no president 
task separately, and executing an OS/8 monitor SAVE command; this can 
be done under BATCH. When a task is executed, its nonresident portion 
is read from this core image file by the swapper. If a task is 
writeable, its nonresident portion will be written into the same file 
when it is swapped from memory. It is likely that a task, writeable 
at execution start-up, would flag itself not writeable at some later 
time when all initialization is completed. The nonresident portion of 
a task is writeable if it must be saved on a mass storage device (swap 
device) before overwriting it in memory with another task. 



7.1.2 Checkpointable Tasks 

Checkpointing is ideally suited for long-running tasks. The system 
can run short tasks in the same area, swap them out of memory, and 
swap the long running task back again. 



7.1.3 Interaction Between Tasks 

Resident tasks can interact with the resident portion of any 
nonresident task. Two nonresident tasks that occupy overlapping 
memory regions can interact with each other through their resident 
partitions. For example, if a nonresident task is executing, it sends 
a message and is then checkpointed. The message recipient can 
acknowledge the sender's message even though the sender is not totally 
resident. However, the message sent must be resident. 



7.2 MEMORY PARTITIONS 

The swappable portion of a nonresident task resides in a memory 

partition. This partition is simply a contiguous block of memory 

locations that is readable in one mass storage call. Every partition 
has the following characteristics: 

• It is wholly contained in one memory field. 

• It has a starting address. 

• It has a length (size) that must divide evenly by 200 (octal) 
since OS/8 file structured devices read and write in one-half 
block (one page) increments. 

• It normally begins at an address which is a multiple of 400. 
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The user can set the parameters for establishing the partition either 
in the parameter file or the source of the Swapper Task. This 
procedure is described in Section 7.4. 

Partitions are mutually distinct, that is, one partition cannot 
overlap another. Any number of partitions can be defined. The n 
partitions are numbered in any order, from to n-1, with partition 
number being the first partition. They need not be adjacent. 

Only one task can occupy a partition at any given time. The occupying 

task owns the partition until that task executes a "free" command 

(described in the next section), or (if the task is checkpointable) as 

long as higher priority tasks that share the partition remain 
nonexecutable. 

It is most convenient if every partition begins on the first location 
of even-numbered pages, that is, the starting address is a multiole of 
400 octal. 



7.2.1 FREE Command 

A free request can be appended to the function argument of some ER's 
(for example, SEND, RECEIVE, etc.) as follows: 

CAL /A CALL TO THE EXECDTIVE 

COMMAND+FREE /"COMMAND" IS ANY RTS/8 EXECUTIVE 
/REQUEST. THE 

/ISSUING TASK IS TO BE SWAPPED OUT OF 
/MEMORY IF SOME OTHER TASK 
/BECOMES EXECUTABLE AND REQUIRES THE 
/PARTITION BEFORE THE FREEING TASK 
/CANCELS THE FREE REQUEST. 

A free request must be combined with some other executive request. If 

the sequence: 

CAL 
FREE 

is issued, it will be interpreted as: 

CAL 
SEND+FREE 

Only nonresident tasks may issue free requests; other free requests 
are ignored. A task may free its own partition, but never the 
partition of another task. 

A task normally frees its partition whenever it must wait for an 
event. If any other task has a pending request for the partition, it 
is swapped into the free partition immediately. If there is no 
pending request for the partition, the freeing task continues to wait 
in the free partition until some other occupant requests residency. 
In either case, once the freeing task becomes executable again, it 
must compete for the partition along with any other executable 
occupants. The freeing task may become executable before any other 
task requests residency in the partition. In this case, the free 
command is cancelled, and the freeing task retains possession of the 
partition. No read or write operation is necessary to effect this 
swap in this case. By freeing the partition whenever the occupying 
task (which may or may not be writeable) must wait for an event, the 
programmer is assured that the partition contains a running (i.e., 
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nonwaiting) task whenever possible. If there are no writeable tasks 
in the partition, no swap device I/O is involved in freeing the 
partition. 



7.3 NONRESIDENT TASK INITIALIZATION 

The following procedure is recommended to implement any RTS/8 system 
containing nonresident tasks. 

1. Code and debug each nonresident task as a resident task. 
During the debugging, load the task being debugged and only 
the tasks required for execution of the task to be debugged. 
Once the task executes correctly while resident, make it 
nonresident. Making a task nonresident is described in the 
sections that follow. 

2. On a listing, mark the nonresident portion of each 
nonresident task. Determine the size of each task's 
nonresident portion. Then design the partitioning scheme and 
allocate nonresident tasks to memory partitions by modifying 
the parameter file as described in Section 7.4. 

3. Re-origin each nonresident task so that its nonresident 
portion lies within its partition. If necessary, ensure that 
resident portions of nonresident tasks do not overlap into 
another partition. BITMAP, an OS/8 utility program, is 
useful for this since it allows the user to determine if two 
or more tasks are erroneously being loaded into the same 
memory section. The use of BITMAP is described in Section 
6.3. A detailed description of BITMAP is given in Chapter 2 
of the OS/8 Handbook. Execute the task as a resident task 
once more to make sure it does not contain location dependent 
code. Also, if any memory partition begins on an odd 
numbered page, temporarily relocate each task that resides in 
that partition. An example of starting a nonresident task at 
an arbitrary boundary is given in Section 9.3. 



7.3.1 Parameters for Nonresident Tasks 

Several assembly parameters must be initialized when employing 
nonresident tasks. Five of the parameters are located in the 
parameter file (PARAM.PA) and three must be included in the 
nonresident task itself. 

The parameter file (PARAM.PA) contains five parameters (PARTNS, 
CHECKP, SWAPPER, SYS and SUNIT) which must be initialized when 
employing nonresident tasking. These parameters are defined as 
follows : 

PARTNS is set to the number of memory partitions defined. 
PARTNS is set to zero in the parameter file to indicate 
that no memory partitions are defined in the system. 

CHECKP is set to 1 if any nonresident task is checkpointable. 

SWAPPER is the nonresident task swapper task; it must be 
assigned a task number that is of higher priority than 
the task it swaps, that is, a number lower in value 
than that of any nonresident task in the system. 
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is set to designate the swap device driver task; for 
example, SYS = RK8 specifies the disk driver task. 

is set to specify the swap device physical drive unit; 
for example, SUNIT = specifies the disk cartridqe 
drive. 



Every nonresident task source must include the followinq three 
parameters: ^ 

PARTNO= n, where n is the task's partition number (starting at 0) 

CPABLE= 0, if the task is not checkpointable 

1, if the task is checkpointable 

WRITE= 0, if the task is not writeable 

1, if the task is writeable 

Failure to initialize these parameters correctly causes the proqram to 
execute unpredictably. The presence of parameter PARTNO identifies a 
task as a nonresident task. Hence, the variable name PARTNO should 
not be used except in nonresident tasks. 

A nonresident task is not appreciably different from a resident task 
However, buffers should not be in nonresident portions of a task since 
the buffers will be out of memory when that task is not being 
executed. There are no special coding restrictions. The nonresident 
portion IS always present in memory while a nonresident task is 
executing. It is generally safe to assume that the nonresident 
portion IS never present when the task is not executing. There is a 
slight structural difference between resident and nonresident tasks- 
nonresident tasks have clearly defined resident and nonresident 
portions that cannot be intermixed. 



7.3.2 Assembling Nonresident Tasks 

Each nonresident task is assembled separately. The nonresident task 
must include the parameter TASK, but never the parameters TASK2 and 
TASK3 (see Section 6.1.5, Task Setup). 

The swap device file that contains the nonresident portion of the 
nonresident task requires special treatment. This file must contain 
the first word of the nonresident portion in the first location of 
relative block 1, the second word of the nonresident portion in the 
second location, and so on. This file must be a core image; however, 
the OS/8 monitor requires that the first location of any core image 
section load into a memory address that divides evenly by 400(octal). 
If the lowest address in the partition also divides evenly by 
400(octal), this condition is met. There is no problem because every 
task can be assembled in the partition directly. 

Modify the parameter file (PARAM.PA) to establish the desired 
parameters. Then assemble the nonresident task and the parameter file 
together . 



7.3.3 Creating the SAVE Image File 

Create a SAVE image file (nonresident disk image) from the binary 
image file as follows: 

.R ABSLDR 

*TASKX.BN$ 

.SAVE DEV TASKX.SV N1-N2 
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For each task, where DEV is the swap device, Nl is the lowest address 
in the partition, and N2 is the highest address in the partition. The 
resulting core images contain only the nonresident portions of each 
task and meet all the requirements previously outlined. However, the 
first block of the core image (relative block 0) is the core control 
block, which is not used by the swapper. As stated previously, it is 
strongly recommended that the partitions begin at a location that is a 
multiple of 400 (octal) since the OS/8 SAVE command only saves areas 
starting at 400(octal) boundaries. 

NOTE 

SAVE image files can be constructed 
under OS/8 BATCH. Also, the OS/8 CCL 
command LOAD may be used to create the 
SAVE image. 



7.4 PARAMETER INITIALIZATION FOR PARTITIONS 

The user must initialize certain parameters to define the partitioning 
scheme. They can be set in either PARAM.PA or SWAP. PA. The following 
three variables are required for each of the partitions: 

MFLDnn= MEMORY FIELD OF PARTITION N 

ADDRnn= MEMORY ADDRESS OF PARTITION N 

SIZEnn= SIZE OF PARTITION N, SPECIFIED IN PAGES 

The user can set up the parameter file to accept eight sets of 
partition parameters. When more than eight partitions are defined, 
the parameter table must be extended according to instructions 
contained in source. Since adding extra partitions does not increase 
system overhead, it is best to have as many partitions as possible. 
This minimizes the number of tasks that must share a partition. Each 
partition should have at least two occupants; otherwise, there is no 
reason for making the task nonresident. The partitioning scheme can 
also be defined by initializing the required parameters within the 
swapper source. 



7.4.1 General Information 

The entire partition table appears on the swapper PAL or CREF output 
listing. The user should check it carefully to ensure that all 
partition parameters (MFLDnn, ADDRnn and SIZEnn for each partition) 
were defined correctly. The parameter file generates the residency 
table entry for each nonresident task and it appears on the PAL or 
CREF output listing for that task. The user should examine word 1 of 
this entry to verify that the nonresident task parameters PARTNO, 
CPABLE, and WRITE were initialized correctly. Word 2 of the residency 
table entry will be zero because the task's block address on the swap 
device is unknown at assembly time. This location is initialized by 
the OS/8 command decoder shortly after program startup, and it can be 
examined anytime thereafter. In the usual case, where the file is a 
core image, this location should contain M+1, where M is the block 
address returned by the following command: 

.DIR DEV:TASKX.SV/B 
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TASKx.sy is the core image on the swap device containinq the 

nonresident portion of the task. v-v^ni-aiiiiuy cue 

7.5 NONRESIDENT TASK IMPLEMENTATION 

Perform the following procedure to implement nonresident tasks. 

1. Assemble every task that will be included in the program as 
described m Section 7.3.2. Obtain PAL or CREF listings and 
bitmaps Finally, obtain a bitmap of the entire system and 
Irl'fL^?^ memory is allocated correctly. On the bitmap, 3s 
are legal only within partitions. 

2. Create the SAVE image file as described in Section 7.3.3. 

3. Load the binaries of the RTS/8 executive and each task, 
including nonresident tasks. Always load the executive 

nrnfr" .^""^^^^^I"^ ^^^"^ ^" included in this operation in 
order to load their resident portions and Executive table 

Tr llTrl .P^"^" tt^^,^^^ ^°^^^<^ program as a core image file 
or start it from the keyboard. 

''' ^htr t^J^l^ti~^nTyo^'°'^'^'' "^'"^ ^^^ monitor R command. 
This calls the OS/8 command decoder, which types an asterisk 
on the console terminal. At this time, initialize the block 
address of each nonresident task core image as follows: 

*DEV:TASKX.SV=N 

In this command line, DEV is the swap device and TASKX.SV is 
I i. ^T°'^^o ^'"^^^ J"-^^ containing the nonresident portion of 
task N. Repeat this procedure for each nonresident task, one 
task per line, and terminate the last line with an ALTMODE. 
This procedure automatically initializes and starts the 
real-time program. 

'^^^^ initialization procedure may be executed automatically 
under OS/8 BATCH control. "•auj.i,dj.j.y 

Example: 

$JOB SYSTEM 

/RUN "SYSTEM" AND INSTALL 

/NONRESIDENT TASKS. 

.RUN SYS SYSTEM 

*TASK1=35 /TASK 35 IS "TASKl" SAVE IMAGE 

*TASK2=36$ /TASK 36 IS "TASK2" SAVE IMAGE 

$END 

Submitting SYSTEM. HI runs RTS/8 user system SYSTEM. SV, 
installing its two nonresident tasks. 

5. Debug the entire program. Accomplish this by selectively 
placing HLT instructions (preceded by lOF, NOP, if 
appropriate) and examining the memory once the HLT has been 
executed. Use the MCR and/or the console switch register to 
place and remove HLT instructions and to modify all 
permanently resident areas. When using MCR, remember that 
MCR output represents a snapshot of memory at some 
undetermined Pomt in time that is long past by the time the 
MCR has output to the terminal. 
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CHAPTER 8 
DEMONSTRATION PROGRAM 



This chapter contains a demonstration of RTS/8 with nonresident tasks 
executing in the foreground. Included is a listing of the modified 
parameter file (PARAM.PA). In addition, there is an example of 
nonresident tasks (Tasks NR20 and NR22) and the assembly and load 
instructions required for implementing the demonstration program. 



8.1 MODIFIED PARAMETER FILE (PARAM.PA) 



/a.S PARAMETERS FOR RTS/8 TASKS ViS+DECNET 

USTFLOa /CHANGE TU 1 TO PREVENT LISTING PARAM 
XLIST USTFLtt 



OPYRIGHT CO 1974, 1975, 1976 BY DIGITAL EQUIPMENT CORPORATION 



ME INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT NOTICE 
NO SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT 
ORPORATION, DIGITAL EQUIPMENT CORPORATION ASSUMES NO RESPONSIBILITY 
OR ANY ERRORS THAT MAY APPEAR IN THIS DOCUMENT. 

THE SOFTWARE DESCRIBED IN THIS DOCUMENT IS FURNISHED TO THE PURCHASER 
UNDER A LICENSE £0H USE ON A SINGLE COMPUTER SYSTEM AND CAN BE COPIED 
(WITH INCLUSION OF DIGITAL'S COPYRIGHT NOTICE) ONLY FOR USE IN SUCH 
SYSTEM, EXCEPT AS MAY OTHERWISE BE PROVIDED IN WRITING BY DIGITAL. 

DIGITAL EQUIPMENT CORPORATION ASSUMES NO RESPONSIBILITY FOR THE USE 
OR RELIABILITY OF ITS SOFTWARE ON EQUIPMENT THAT IS NOT SUPPLIED BY 
DIGITAL. 
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/RTS8 va EXEC PARAMtTERS - EDITED BY USER 

P0P6E«l 

PDPie»B 

EAEie 

PWRPAL'B 

^■16^'e /NUMBER OF MBA'S IN USE 

/I.E. 1 IF ONE KL8A (UP TO 4 LINES) 

IFOEF CUR < 

NTASKs-e^""" "BH'-LO-cuRsaeea «curbio,,error^» /flag warning if undefined field seen 

CHECKP«1 
PAHTNS'l 

/ITflE N partitions ARE NUhdhRtO FROM e TO N-1) 
/COMMON TASK NUMBERS - EDITED BY U5ER- 

^IL^^.f^^P"^^ ^° '^EPI'^E *l-l- TASKS HERE, NAMES GIVEN BELOW 
A^rut^^r 11^°"^ *''"^" TASKS AND SHOULD REMAIN COMMENTED OUT 
/IF THE COHRESPONUING TASK IS NOT INCLUDED IN THE SYSTEM 

^f^f*''* /PO«ER FAIL HANDLING TASK 

CLDCK«l 

SMAPPER*16 

TTY»2 

LPT«3 

MCR»« 

/DTA" /OECTAPE DRIVER TASK 

''LTA» /LINCTAPE DRIVER TASK 

«K8»7 

/tfei' /HFB8 DISK DRIVER TASK 

/DF32« /0F3a DISK DRIVER TASK 

'CSA« /CASSETTE DRIVER TASK 

''CSAF" /CASSETTE FILE SUPPORT TASK 

''UOC* /UNIVERSAL DIGITAL CONTROLLER TASK 

/RXBA. /HRST FLOPPY CONTROLLER 

/RKSB* /SECOND FLOPPY CONTROLLER 

/RXSC' /THIRD FLOPPY CONTROLLER 

/"XBD" /FOURTH FLOPPY CONTROLLER 

0S8-NTASKS 

0S8F»15 

NRseaae 
NR2a>2a 

/DDCMP" /DOCMP TASK FOR DECNET 

•"^SP" /NETkiORK SERVICES PROTOCOL TASK 

'MP" /NETWORK INFORMATION PROGRAM 

/JUK" /NETWORK TERMINAL COMMUNICATIONS TASK TRANSMITTER 

''1-SN» /NETWORK TERMINAL COMMUNICATIONS TASK RECEIVER 

/NULLSA. /NULL JOB FOR PDP-8/A 

/EXIT' /EXIT TASK 

/DKC8A" /AUXILIARY DKC8A HANDLER 



/SOFTWARE PARAMETERS - EDITED BY USER 

XLIST 1 

IFDEF ose < 

XLIST L8TFLG 



/DEFAULT IS OSTTDV-1 



OSFLDS>a 

0STTDV«31 

0SKBDV>3e 

0SSYSD«WK8 
aSPILL>0 

/CEG 4 FOR iHie BAUD VT05) 
/0S8QRG" /ORIGIN (IN FIELD B) 

XLIST 1> 

IFOEF MCR < 

XL18T LSTFLG 
'""•^LKi /B IF MCR TOO FACILITIES TO BE OMITTED CDEFAULT • I) 

MCRSYS" 1 

/I IF DESIRED (DEFAULT) 
/MCRFLD. /FIELD OF MCR 

/MCHORG' /LOCATION OF MCR (DEFAULT IS END OF FIELD) 

/MCRPRT" /PARTITION NUMBER OF MCR (IF NON.RESIDENT) 

/MCRCDV. /CONSOLE TO BE USED BY MCR, E.G. TTY 



XLIST l» 
IFDEF CLOCK 
XLIST LSTFlG 

CLKTYP»e 

CLKQLNaae 



/DEFAULT IS TTY 



DECIMAL 

HERTZ'iaee 



/MAY BE CHANGED BY USER 
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SHERTZ'l 



IFNZRO 

OCTAL 

XLIST 



CLKTYP&l «MfcKTZ»1750> 
I* 



/FORCE 0K8EP,KW12 TO 1 HHZ 



/tPTLOC" 
/URTFL,Oi 



IFOEF LFT 



> 
IFOEF 



OTA 



/DTAUOCi 
/OTAFLD" 



TBLLST" e 



/SYSTEM LOCATIONS! 



/SET TO 'LSTFLG' IF YOU DON'T DESIRE 
/TO SEE TABLES WHEN PARAMETER FILE IS 
/NOT LISTED. 



MSGTBL> leea-a 

TSTABL' NTASK8 + 2*iJ*«SGT8L-« 
TFTABL" NTA8KS*2-«+T5TABL-l 



SYS'RKS 

suNiT«a 



XLIST 
IFDEF 
XLIST 



/TASK MESSAGE TABLE 
/TASK STATE TABLE - MOLDS 
/TASK LINK,UM,OF»IF,PC,AC,MQ 
/TASK FLAGS TABLE • MOLDS 
/TASK STATUS FLAGS 



SWAPPER < 
LSTFLG 



IFNOEF SUNIT 
FIELD B 



<SUNIT> 0> 



/DEFAULT SMAP UNIT IS B 



/PARTITION TABLE CPARTBL) ENTRIESI 

/MUST BE INITIALIZED BY USER AS EXPLAINED IN THE COMMENTS 

/DON'T FORGET TO REMOVE LEADING "/" FROM LINES USED 

RESTBL* TFTABL+NTASKS+B /RESIDENCY TABLE 

PARTBL" NTASKS-SWApPER*2*RESTBL*3i7774 /PARTITION TABLE 

•PARTBL 

XLIST 1 

IFNZRO PARTnS < 

XLIST TBLLST 

MFLDee>i 

ADDRee><ti)0 

siZEoeii 

SIZEBB"l0+MFLDe0*lB*«0B0 

ADDRBB 

ZBLOCK 2 

XLIST 

IFNZRO PARTNS-l < 

XLIST TBLLST 
MFLD01" /MEMORY FIELD OF PARTITION »l 

ADDRBli /LOWEST ADDRESS IN PARTITION #1 

SIZEBli /SIZE OF PARTITION «1 CCORE PAGES) 

SIZEai"10*MFLOBl*lB*40Bia 

ADORBl 

ZBLOCK 2 

XLIST 

IFNZRO PARTNS-2 < 

XlIST TBLLST 
MFLDB2* /MEMORY FIELD OF PARTITION *2 

»DDRB2» /LOWEST ADDRESS IN PARTITION «2 

SIZEB2> /SIZE OF PARTITION «2 

SIZE02"lB*MFLD02"lB*«0aB 

ADDRB2 

ZBLOCK 2 

XLIST 

IFNZRO PARTN8-3 « 

XLIST TBLLST 

/PARTITION #3 



MFLDB3* 
AODR03I 
SIZE03* 



MFLD04' 
ADOR04> 
SIZEBaa 



SI^E03-^B♦M^LD03*10+«000 

ADDReS 

ZBLOCK 2 

XLIST 

IFNZRO PARTN8-« < 

XLIST TBLLST 

/PARTITION »4 



SIZE04"I0*MFLU0«"1 0*4000 
ADDRBtt 
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ZBLOCK 


i 




XLIST 






IFNZRO 


partns-5 




XL18T 


TBLLST 


MFL0B5» 




/PARTITION #5 


A0DRZ5' 






SIZE05I 








sizeas- 


'lB*MFLDB5*ia*4a00 




ADORes 






ZBLOCk 


2 




XUJST 






IFNZRO 


PARTNS-6 




XLIST 


TBLLST 


MFUO06" 




/PARTITION «6 


ADOReb- 






SIZEia6> 








SIZEe6- 


ia+MFLD06"j0*aBaa 




ADDR06 






ZBLOCK 


s 




XLIST 






IFNZRO 


PARTNS-7 < 




XLIST 


TBLLST 


MFLuar" 




/"Partition »7 


ADDR07> 






SIZEa7i 








SIZEBT- 


ia*MFLD07"10*4eBM 




AODRer 






ZBLOCK 


3 




XLIST !>>»>>» 



^r'!2ri°^*'- f^STlTlONS MAY BE DEFINED BY THE USER AS SHOWN A 
/FURTHERMORE, THE PARTITION TABLE MAY RESIDE ANYWHERE IN FIE 



BQVE 
LD ZERO 



PRTEND". 

XLIST 

IFOEF 

XLIST 

TTOEVi 

KBDEVi 

CONSOL' 

VT5B" 

SCOPE* 

FILL" 

WIOTMi 

TAB» 

OLDTTY" 

LSBOTi 

TTFLO" 

TTLOC" 



/NOTE END OF PARTITION TABLE 



1» 

TTY 

l8tflg 



XLIST 

IFNZRO 

XLIST 

/KLSADVi 

/KL8ACT» 

XLIST 
IFOEF 
XLIST 

/EXITFLD" 

/EXITLOC" 

XLIST 
XLIST 



1» 

KUSA 

L5TFLG 



1> 

EXIT 

LSTFLG 

/flELO 



/PRINTER DEVICE CODE - DEFAULT IS « 

/KEYBOARD DEVICE CODE - DEFAULT IS TTDEV.l 

/I MEANS CONSOLE TTY (DEFAULT) 

/I ENABLES CTRL/8 AND CTRL/Q 

/I MEANS TTY CAN 00 A BACKSPACE 

/NUMBER OF FILL CHARACTERS, I.E. 4 

/TTY LINE WIDTH (B MEANS INFINITE), DEFAULT IS 130 

/I IF TTY HAS HARDWARE TABS 

/I TO USE OLD 2-PASE TTY HANDLER 

/I LISTS BOTH HANDLERS (DEFAULT 0) 

/FIELD OF TTY TASK (TIMES IB) 

/LOCATION OF TTY TASK 



/KLBA DEVICE CODE - DEFAULT IS 40 

/KL8A CONNECT ROUTINE PAGE - DEFAULT IS 74BB 



OF EXIT TASK (TIMES 
/LOCATION OF EXIT TASK 
1> 
LSTFLG 



10] 



IFNDEF P0P6E <PDP8E»l» 

IFNDEF PUP12 «POPia»0» 

IFNDEF EAE <EAE>0> 

IFNDEF PWRFAL <PWRFAL"a> 

IFNDEF KL8A <KLBA>0> 



XLIST 
IFOEF 
XLIST 



MAXCCB* 



MAXNODi 
NSPFLD* 

NSPLOC* 2600 

NOONUM» 



i 

NSP < 

LSTFLG 

/NUMBER OF LOGICAL CHANNELS (CCB'S) BEING USED 

/E.G. 3 FOR 3 CHANNELS 

/These are numbered i,g,3 

/NUMBER OF NODE NAMES IN NODE TABLE 

/FIELD OF NSP TASK AND MOST NETWORK TABLES (E.G. 30) 

/(TABLES INCLUDE CCBTAB, LNKTAB, NODTAB AND NETTAB) 

/ORIGIN OF NSP TASK. MUST BE .U. 3200 

/THE DEFAULT IS CURRENTLY 320B 

/NODE NUMBER OF THIS NODE 
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/IMPORTANT HELATIVE 0RI6IN8 WITHJN NETWORKS TASKS 



DRLXIT> N3PL0C*4aeB 
CCBTAB' DRLXIT+2B0 
NODTAB« CCBTAB+iee 
NtTTAB" N0DTAB*6a 



/ADDRESS OF AST DE-QUEUER 

/ADDRESS OF CCB TABLE 

/ADDRESS OF NODE TABUE 

/ADDRESS OF NETWORK 'INFORMATION' TABLE 



/THE DEFAULT NETWORKS TASKS USE CORE AS FOLLOWS: 



/ddcmp: page a, aiea-3577 

/NSP: PAGE 2, 3^00-7577 



CI L1NE» i PAGE NODE POOL) 



/NETWORK TASKS USE PAGE AS FOLLOWS: 



/DDCFLO: 
/NSPFLO: 



iB-ia, 38-77 
lS-17, 77-177 



/NODE TABLE ENTRIES 

/EACH ENTRY HAS THE FORM 

/WORDS 1-3 NODE NAME (6-BITi 0-PADOEO) 

/WORD 4 LINE NUMBER 

/WORD 5 BIT 0il IF ADJACENT NODE 

/ BITS 4-11 CONTAIN NODE NUMBER 

IFOEF TASK < IFZERO TASK-NSP « 

FIELD NSPFLDX10 

•NOOTAB 



NODTAB, TEXT /N*ME/ 



•NETTAB+4 
NODNUM 

TEXT /NAME/ 
FIELD 
>> 
> 



/LINE NUMBER 
/NODE NUM8EK 

/OUK NODE NUMBER 
/OUR NODE NAME 



MAXLIN" 



MAXPKT" 24 



/KG6E* 
DDCFLD> 

DDCLOCa 0200 



LCBSIZ* 32 
PKSUE' 14 



XLIST 1 

IFDEF DUCMP < 

XLIST lSTFLG 

/number of physical lines being used 
/e.g. 3 for 3 lines 
/These are numbered 0,i>2 

/Set TO NUMbER OF NODE POOL PACKETS TO ALLOW 

/The node pool exists at the end of ddcmp 
/just before the lcb table csimilar to the clock queue] 
/each packet requires 14 words octal. (about 10. per page) 
/cthe default requires 2 pages core) 

/SET TO lOT SKELETON IF KG8E IS PRESENT (E.G. bllB) 

/field of ddcmp task.lcbtab and 'node pool" (e.g. 20) 

/This field must be different from nspflo 

/origin of ddcmp task 

/the above must be below 5000-size of node pool and lcbtab 

/the default is currently 200 

/global definition of lcb size (do not alter) 

/SlOBAL DEFINITION OF PACKET SIZE CDO NOT ALTER) 



DOCFNC DDCLOC /ADDRESS OF DDCMP 'FUNCTION CALL' ROUTINE 

HEAOPKi DDCLOC*3020 /ADDRESS OF START OF PACKET FREELIST 
LCBTABi MAXPKT"PKSIZE*HEADPK /ADDRESS OF LINE CONTROL BLOCK TABLE 

/IMPORTANT NETWORKS PAGE GLOBALS 

/DDCMP I/O EVENT FLAG 

/LOCATION OF I/O PACKET FREELIST HEAD 

/POINTS TO TAIL OF DDCMP INPUT QUEUE 

/POINTS TO HEAD OF DDCMP INPUT QUEUE 

/POINTS TO TRANSMIT COMPLETE RING BUFFER 

/LOCATION OF HEADER BUFFER FOR TRANSMITS 

/HEADER CRC FOR TRANSMITS 

/DATA CRC FOR TRANSMITS 

/DATA DESCRIPTOR FOR TRANSMITS 

/DEFAULT USER OF DDCMP TASK 



/FIELD OF NIP CTIMES 10) 
/LOCATION OF NIP 
/PARTITION FOR NIP 
/SET TO 1 TO GET SHORT NIP 



DDCcF. 


46 


FREHD* 


47 


DOCTL- 


50 


DDCHO" 


51 


ATNINPi 


52 


OHDR> 


5S 


OCRCL- 


63 


DDCRCL» 


bb 


OUTCOFt 


67 


DDCUSR' 


NSP 


XLIST 


1» 


XLIST 


1 


IFOEF 


NIP 


XLIST 


LSTFLG 


/NIPFLD« 




/NIPLOCi 




/NIPART" 




/SKIMP" 
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XLIST 1 



/TLKLOC* 
TLKCHN« 



/LSMFLD" 
/LSNLOC» 
LSNCHNi 



/DEVICE NIP OUTPUTS TO 

/DEFAULT IS UPT If IT EXISTS (OTHERWISE TTY) 

/LOCATION FOR RESIDENT PORTION OF NIP 

/REQUIRED ONLY IF MPART DEFINED 

/DEFAULT IS NIPLOC-2B0 

> 



IFDEF TLK < 

XLIST L5TFLG 

/FIELD OF TLK TASK 

/START OF TLK TASK 

/Cca CHANNL TO ASSIGN TO TLK TASK 

XLIST 1 > 

IFDEF LSN < 

XLIST L5TFLG 

/FIELD OF LSN TASK CTIMES 
/START OF TLK TASK 
/CCB CHANNL TD ASSIGN TO LSN TASK 

XLIST 1 > 

XLIST L3TFLG 



103 



/EOUIVALENCES: 

ACTTTfe* CLL STA RAL 
AC7775" CLL STA RTL 
AC400e« CLA STL RAR 
AC37771 CLL STA RAR 

Aceeee* cla stl rtr 

ACBB08" Cla STL RTL 
/MONITOR CALL VALUES: 



CAL» JMS 
POSTOS" JMP I 
WAITM« JHS I 



SEND" e 

RECEIVE 1 

MAITEa 2 

RUN> 3 

SUSPNO* 4 

POST' 5 

SKPINS' 6 

DERAIL" 7 

BLKARG' IB 

SENDM« 11 

UNBARG' 12 

RESCMD" 13 

WAITXS 10 

FREE' 4BBB 



24 



/CALL THE EXECUTIVE 
/DISMISS AN INTERRUPT 
/HAIT FOR MULTIPLt EVENTS 



/note: "*»" MEANS CRITICAL VALUE MAY NOT 

/BE CHANGED WITHOUT MODIFYING SYSTEM CODEll 

/SEND MESSAGE 

/RECEIVE MESSAGE 

/WAIT FOR EVENT FLAG 

/CONTINUE TASK EXECUTION 

/SUSPEND TASK EXECUTION 

/POST AN EVENT FLAG 

/INSERT CODE INTO INTERRUPT SKIP CHAIN 

/INITIATE ENU-ACTION 

/BLOCK TASK FOR REASON SPECIFIED IN ARC 

/SEND MESSAGE AND WAIT 

/UNBLOCK TASK FOR REASON SPECIFIED IN ARG 

/FORCE A RESCHEDULE 

/WAIT FOR EXACTLY THIS EVENT FLAG 

/**FREE PARTITION 



XLIST 1 

IFDEF UOC < 

XLIST LSTFLG 

A0'B>DO>i;0I*S>GC>3rEC>4|RC*5 

OC»6;ECT»7jCS»l0»DCT»l»;AIil2 

XLIST l» 

XLIST LSTFLG 



/TASK STATUS FLAGSI 



NONRWT" 


4BaB 


EFWT» 


2BBB 


RUNWT> 


IBBB 


SWPWT' 


BttBB 


EORMWT» 


B2eB 


USERWT' 


SIBB 


ENABWTi 


BB4a 


MSGWT" 


Be2B 


NETWT» 


BBIB 


ONEWTi 


BBet 



/•♦NONRESIDENT TASK WAIT 
/tvENT FLAG WAIT 

/Schedule wait 

/••swapper wait 

/event flag or message wait 

/ustr specified wait 

/enable wait 

/message wait 

/network wait (reserved for possible future use) 

/••does not exist wait 



IFNIRO KLSA «IFNDEF KL8ACT 

KLUD> KLeA.l/3"2BB 

KLSACTi 74Be.KLUD» 

T8WFLG* 35 /TASK 8W INHIBIT FLAG 

TOOL* 36 /LOW ORDER TIME OF DAY 

TOOH» 37 /HIGH ORDER TIME OF DAY 

DATE" 40 /DATE IN 086 FORMAT 

MCREFi 41 /MCR START EVENT FLAG 



IN FIELD B 

IN FIELD e 

IN FIELD e 

IN FIELD e 

IN FIELD e 
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/SOME USEFUL EQUATES FOR TTV AND LPT MESSAGES! 



NOPACK»«01ilB /TEXT IS NOT PACKED IN 6-BlT 

NOCRLF»a0a0 /OUTPUT SHOULD NOT BE FOLLOWED BY CR/LP 

iND"ieee /outtxt pts to first word of text 

N0LINE»«B*1 /input is IN CHARACTER MODE 

AssGN«eee /assigns device 

KLSALINE'lae /USED TO SPECIFY A LINE OF A KL8A 



XLIST 1 

IFDEF CLOCK < 

XLIST LSTFLG 

SOME USEFUL EQUATES FOR STANDARD CLOCK MESSAGES! 



MARKTIME" 
SCHEDULE! 
TIMOUT" 
PERIODICALLY! 



CANCEL* 
XLIST l> 



XLIST 
IFDEF 
XLIST 



1 
TASK 



200ID 



T00b 



/POST EVENT FLAG AFTER SPECIFIED INTERVAL 

/RUN TASK AFTER SPECIFIED INTERVAL 

/DERAIL TASK AFTER SPECIFIED INTERVAL 

/USED AS MODIFIER TO 'SCHEDULE' 

/RE-QUEUES RUN REQUEST AFTER SPECIFIED INTERVAL 

/E.G. 'SCHEDULE FOO PERIODICALLY' 

/DELETE ALL REQUESTS FROM SPECIFIED TASK FROM QUEUE 



/FORCE LISTING OFF 



/TASK TABLE SETUP • "TASK", "CUR", "INIWT"# AND "START" 
/MUST BE DEFINED BY TASK! 

IFNDEF INIWT <1NIWT«B> 
IFNDEF INIWT2 «IN1WT2«0> 
IFNDEF INIWT3 <INIWT3»0> 



*TASK*2*MSGTBL 

ZBLOCK B 

»TA8K*«*T8TABL 

CURX10*CU^ 

START 



XLISTJ IFDEF 

XLIST 

VERS 

XLIST > 

XLIST 

•TASK+TFTABL 

INIWT 

XLIST 



/MESSAGE BUFFER INITIALLY CLEAR 

/INITIAL FLAGS 

/INITIAL AC 
VERS < 

/INITIAL MQ 



IFDEF TASKS 

XLIST 

•TA8K2-a*M8GTBL 

ZBLOCK 2 

*TASK2*«*TSTABL 

CUR2%10*CUR2 

STARTS 



XLIST> IfDtF 

XLIST 

VERS2 

XLIST » 

XLIST 

*TASK2+TFTABL 

INIWT2 

XLIST 

> 



/MESSAGE BUFFER INITIALLY CLEAR 

/INITIAL FLAGS2 

/INITIAL AC 
VERS2 « 

/INITIAL MO 



IFDEF TASK3 

XLIST 

*TASK3-2*MSGTBL 

ZBLOCK 2 

*TASK3"a*TSTABL 

CUR3X10+CURi 

STARTS 



XLISTI IFDtF 

XLIST 

VERS3 

XLIST > 

XLIST 

•TA8K3*TPTABL 

INIWT3 

XLIST 



/MESSAGE BUFFER INITIALLY CLEAR 

/INITIAL FLAGS3 

/INITIAL AC 
VERS3 < 

/INITIAL MQ 
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IFOEF TASK < 
IFOCF PARTNO < 
XLIST 

/RESIDENCY TABLE iRtSTBLJ fcNTRYl 

/initialized for nonresident tasks only 

•task-smapper-1*£*restbl 
partno-4*Partbl*cpable*cp*ble+write 

XLIST 

IFNOEF SWAPPER <NOSw*P,^ERROR^> /SWAPPER MI5SIN6 

IFNZRO TASK.SWAPPER»«0B0 <8WPRIO,^ERROR^»/NON-RESI0eNT TASK 

»» /H*S PRIORITY HIGHER THAN SWAPPER 

IFOEF PARTNO < 

IFNDEF TASK <NOTASK,^ERROR . > /PARTITION BUT NQ TASK 

IFNOEF SWAPPER ^NOSWAP.IeRROR:* /PARTIT ON BUT nS sSJpPER 

FNDEF PARTNS «NOPART,,ERROr:» /MISSING PARTITIONS 

IFZERO PARTNO-PARTNSSaaea <PRTERR,^ERRoJ:» /PARTNO.GE.PARTNS 

XLIST a 



8.2 NONRESIDENT TASK LISTINGS 

The following are listings of nonresident tasks (NR20 and NR22) 

8.2.1 Nonresident Task NR20 
TASK«20 

0020 TASK^SK) 

0S20 TASKsSki 

0400 START»4a0 

0001 WRITE"! 

0001 CPASUE'l 

0010 CUR«10 

5000 INIWT«RUNWT+N0NRWT 

0000 PARTNa»0 

0001 FIELD tURXie 
0400 niidH 

10400 4020 CAL 

10401 4011 SENDW+FREE 

10402 0001 CLOCK 

10403 0600 SLPMSG 

10404 4020 CAL 

10405 4011 SENDW+FREE 

10406 0003 LPT 

10407 0606 LPTH8G 
10«10 5200 JMP START 

0600 *600 

10600 0000 SLPMSGf 28L0CK 3 

10603 0000 

10604 0000 0;SHERTZ 

10605 0001 

10606 0000 LPTMSG, 2BL0CK 3 

10611 0000 

10612 0000 

10613 2401 TEXT /TASK 20 RUNNlNb/ 

10614 2313 

10615 4062 

10616 6040 

10617 2225 

10620 1616 

10621 1116 

10622 0700 
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8.2.2 Nonresident Task NR22 



TASKa22 








0022 


TASK«22 






0022 




TASK»22 




0400 




START«400 




0001 




wRITE«l 




0001 




CPABLE»l 




0010 




CUR*10 




5000 




INIWT«RUNWT+NONRWT 




0000 




PARTNO"0 




0001 




FIELD CURX10 




0400 




*400 


10400 


4020 




CAL 


10401 


4011 




sendw+free 


10402 


0001 




CLOCK 


10403 


0630 




SLPM$G 


10404 


4020 




CAL 


1040S 


4011 




SENDW + t-REE 


10406 


0003 




LPT 


10407 


0636 




LPTMSG 


10410 


5200 




JMP START 




0630 




*630 


10630 


0000 


SLPM5G, 


ZBLOCK 3 


10633 


0000 







10634 


0000 




0;SHERTZ 


10635 


0001 






10636 


0000 


LPTMSG, 


ZBLOCK 3 


10641 


0000 







10642 


0000 







10643 


2401 




TEXT /TASK 22 RUNNING/ 


10644 


2313 






10645 


4062 






10646 


6240 






10647 


2225 






10650 


1616 






10651 


1116 






10652 


0700 







8-9 



DEMONSTRATION PROGRAM 

8.3 ASSEMBLY AND LOAD PROCEDURE 

The assembly and load procedure for the demonstration proqram is as 
follows: 

. P A I... R T S 8 •::: P A R A M y R T S 8 

l=:rrors detected: o 
LINKS generated: 

, PAL CLOCK<PARAM .- CLOCK- 
ERRORS detected: 
LINKS generated: 

,PAL MCR<PARAM»MCR 

ERRORS detected: 
LINKS generated: 

♦ PAL. S 8 S U P < P A R A M !. S 8 S U P 

ERRORS detected: 
LINKS generated: 

.PAL TTY<PARAM?TTY 

ERRORS detected: 
LINKS generated: 

»PAL LPT<PARAM»LPT 

ERRORS detected: 
LINKS generated: 

♦ P A L R K a E < P A R A M K R K 8 E 

ERRORS detected: 
LINKS generated: 

. PAL NR20<PAR AM v NR20 

ERRORS detected: 
LINKS generated: 

. PAL NR22<PARAM 9 NR22 

ERRORS detected: 
LINKS generated: 

♦ pal swa p < p a r a m r s w a p 

errors detected: o 
LINKS generated: 

.R AB5LDR 

*NR20$ 

.SA SYS NR20 :l.0400-10577 

.R ABSLDR 

*NR22!r. 

.SA SYS NR22 10400 -:l.0577 

.R ABSLDR 

*RTS8 9 MCR f CLOCK > RK8E > TTY > LPT r 0S8SUP 

!KSUAP!-NR20»NR22$ 

.SA SYS RTS8V2 

This example shows the assembly of the parameter file and the source 
task itself. The binaries of each nonresident task are then loaded 
into memory, and their nonresident portions saved on the swap device. 
All tasks are then loaded using the ABSLDR with the RTS/8 Executive 
being loaded first. Finally, the core image of all the tasks in 
memory is saved using the OS/8 SAVE command. 
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8.4 NONRESIDENT TASK ASSIGNMENT AND EXECUTION 

The following is the execution of RTS/8 showing the assignment of 
tasks NR20 and NR22 to the system. 



,R RTssy; 


> 




)KNR20=20 






*NR22^:=22 






!K*>SY 






01. c;lck 







02 TTY 


M 




03 LPT 


M 




04 MCR 






07 RK8 


M 




1 5 0S8F 


M 




16 SWAP 


R 




20 


R 


N 


22 


R 


N 


23 0S8 


E 




>RE 20 






>RE 22 






>EX3:T 







In the above example, the user terminates the installation of 
nonresident tasks with an ALTMODE, and returns to the MCR. A SYstat 
command is executed which prints a system status report (see Section 
6.2.9). The REquest command is then used to run tasks NR20 and NR22. 
Shown below is output from tasks NR20 and NR22 on the line printer. 

TASK 20 RU^NI^G 
TASK 20 RUNNING 
TASK 20 RUNNING 
TASK 20 RUNNING 
TASK 22 RUNNING 
TASK 20 RUNNING 
TASK 22 RUNNING 
TASK 20 RUNNING 

The EXIT command is typed to terminate RTS/8 execution and return to 
the OS/8 monitor. 
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CHAPTER 9 
ADVANCED RTS/8 PROGRAMMING TECHNIQUES 



9.1 PERFORMING A RESCHEDULE 



9.1.1 Writing Delicate Code 

Frequently, a task needs to manipulate data in another task or a 
common area. Since tasks are running 'simultaneously', problems will 
arise if two tasks want to access the same data at the same time. 
Consequently, delicate code wants to run with interrupts disabled 
while accessing data in another task. 



NOTE 

Interrupts may be disabled temporarily 
using either a lOF/ION pair or, on 
machines with memory extension, a CIF 
instruction which inhibits interrupts 
until the execution of the next JMP or 
JMS instruction. 



For example, suppose Task A increments location COUNT occasionally and 
Task B decrements location COUNT from time to time during program 
execution. The code might look like the following: 

/TASK A 
LOOPA, 



X, 



COUNT, 

/TASK B 
LOOPB, 



ISZ COUNT 



JMP LOOPA 




Z, 



STA 

TAD COUNT 

DCA COUNT 
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JMP LOOPB 

If Task A increments COUNT the same number 

decrements COUNT, it would be assumed that COUNT would be at the'end 

of the program. However, this is not necessarily 

condition can occur. 



of times that Task 



so 



since 



race 



Suppose 
waiting 
Task B 
after 1 
ready t 
noting 
suspend 
7, and 
contain 
program 



that Task A has a higher priority than Task B, and Task A is 
tor an event to occur with COUNT currently containinn ;:, a 
IS ready to decrement COUNT. However, an interrupt occurs 
ocation Y has been executed. The AC contains a SanS Task B is 
"tllrtV T'\'T.''T^' "'^^ interrupt servS ^outL:? 
s 5ask I L/IT. t \"r ''^''^"^ ^°' ^""^ 3ust occurred, no; 

s Task B and resumes Task A. Task A now bumps COUNT from 6 to 

ina a% TnT ., ""c -'^^^P' ""^^^ ^ ^hen resumes with the AC 

execution ^ "^ ""^'"^^ '^ incorrect for proper 



Iroun^'^th!'°!^ ^^ prevented from happening by disabling interrupts 
be employed: '^'^""^^ ^"'^^ ' ^^^^er of the following two Llutions Ln 



£>Oil 


ition 


1 




Solution 2 


/TASK 
LOOPB , 


B 

• 




/TASK 
LOOPB , 


B 

• 


z. 


STA 
lOF 
TAD 
DCA 
ION 


COUNT 
COUNT 


Y, 

z, 




CIP CUR 

STA 

TAD COUNT 

DCA COUNT 



JMP LOOPB 



JMP LOOPB 



Solution 2 (only usable on machines with memory extension) uses the 

nil, TMD TMc"- ^'"''^ .^^ temporarily inhibits interrupts until the 
next JMP or JMS instruction is executed. uulxj. cne 



9.1.2 Inhibiting Task Switching 

Although the procedure in the previous section can be used, it at 
times can be very inefficient. If it is desired to perform a lot of 
manipulation on data which could be accessed by other tasks, it may be 
inappropriate to turn off interrupts. Inhibitinq interrupts for long 
periods of time could affect other portions of the system Shere timed 
HZnL ^'% "'t'^- .^'^P^-^tant. Also, an interrupt can be lost (for 
example, clock interrupts) if interrupts are turned off for a 
significant amount of time. 



R?q/« R I ' ^K^^^^ solution is possible. A task can inform the 
RTS/8 Executive that it wants to continue to run, and that while it is 
executing a certain piece of code, no other task should run even if a 

?nhVK-^ J^t' priority becomes runnable. This process is known as 
inhibiting task switching. 
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Task switching should be inhibited only under unusual circumstances 
and performed with care. While task switching is inhibited, 
interrupts may still occur and the interrupt service routine will get 
control. However, if task switching is inhibited, the interrupt 
service routine will always return control to the interrupted task 
after the interrupt has been serviced even if higher priority tasks 
are now runnable. 



NOTE 

If the user wishes to manipulate data 
which is accessed by an interrupt-level 
routine, interrupts must be inhibited 
since inhibiting task switching alone 
will not be sufficient in this case. 



There are two methods 
follows : 



of inhibiting task switching which are as 



Method 1: Task switching is automatically inhibited whenever a task's 
PC is less than 100. Thus, delicate code could be placed in the 
bottom of page of any field. 

Method 2: A task may inhibit task switching by zeroing location 35 in 
field 0. This location is symbolically referred to as TSWFLG (task 
switching flag) and is defined as such in the parameter file. In 
either case, after the task is through with its delicate code, it may 
not be sufficient for the task to reset TSWFLG to its original 
value (1). This is due to the fact that there may be some other 
higher-priority task that is entitled to run but did not run because 
task switching was inhibited. The user can find this out by 
interrogating location TSWFLG. If another task became runnable while 
task switching was inhibited, the RTS/8 executive sets the task 
switching flag to -1. When a task is ready to allow task switching 
again, it must examine this flag before resetting it to 1. If it was 
-1, the task returns control to the RTS/8 scheduler. This is 
performed by using the RESCHD ER as follows: 

CAL 
RESCHD 

This ER causes RTS/8 to perform a reschedule that allows the runnable 
task of highest priority to be executed. If a user does not perform a 
RESCHD after re-enabling task switching, then a higher priority task 
which is entitled to run might not run until the next interrupt 
occurs. The interrupt may never occur, or if it does, it may be too 
late for proper program execution. 

The preferred code for inhibiting task switching for Task B which was 
described previously is shown below: 

/TASK B 
LOOPB , 





CDF 







DCA 


I (TSWFLG 




STA 




Y, 


TAD 


COUNT 


z. 


DCA 


COUNT 




ISZ 


I (TSWFLG 



/INHIBIT TASK SWITCHING 



/ALLOW TASK SWITCHING 
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JMP .+3 

CAL 

RESCHD 
CDF CUR 



/SHOULD WE RESCHEDULE? 
/YES 

/NO 



JMP LOOPB 



NOTE 

Interrupt level routines should not look 
at or set the TSWFLG. 



A suiniTiary of TSWFLG states is shown in Table 9-1. 



Table 9-1 
Summary of Task Switching Flag (TSWFLG) States 



TSWFLG State 



Task switching allowed 

Task switching inhibited 

Task switching inhibited; 
reschedule as soon as possible 



Value 



1 


-1 



9.2 EXECUTIVE REQUESTS FOR ADVANCED APPLICATIONS 



9.2.1 WAITM - Waiting for Multiple Event Flags 

Sometimes it is desirable to wait for a logical combination (AND or 
OR) of Event Flags. Waiting for the logical AND of two Event Flags is 
quite simple. The sequence: 



CAL 

WAITE 

A 

CAL 

WAITE 

B 



/WAIT FOR EVENT FLAG A 



/AND THEN WAIT FOR EVENT FLAG B 
waits until both A and B have been POSTed . 

Waiting for the logical OR of several event flags is more difficult 
since there is a possible race condition between the various tests and 
the interrupts (or task executions) which POST the Event Flags 
involved. The key to waiting for an OR of several Event Flags 
successfully is not to allow any interrupts to occur between the 
testing of the first Event Flag and the placing of the task in a Wait 
state if none of the flags were POSTed. 
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This is accomplished by using a special sequence of instructions and a 
special RTS/8 call named WAITM. WAITM is defined as JMS I 25. It 
must be executed with interrupts off, the Instruction Field set to 
and the Data Field set to the current field, and it must be followed 
by a word containing the blocking bit(s) to be set in the Task Flags 
Table. The action of WAITM is equivalent to the action of the RTS/8 
BLKARG ER except that a fast path through the RTS/8 Executive is taken 
and interrupts remain off until the blocking bits are on in the Task 
Flags Table. 

For an example of the use of WAITM, assume that a task "TASK" wants to 
test two Event Flags A and B. If A is POSTed , control should go to 
location ADONE; if B is POSTed control should go to location BOONE. 
If neither is POSTed, the task must wait until one of them is POSTed. 
The code to perform this function is: 



TESTAB, lOF 

TAD A 

SNA CLA 

JMP ADONE 

TAD (4000+TASK 

DCA A 

TAD B 

SNA CLA 

JMP BDONE 

TAD (4000+TASK 

DCA B 

CIF 

CDF CUR 

WAITM 

EFWT 

JMP TESTAB 



/INTERRUPTS OFF - DELICATE CODE 



/ADONE MUST TURN INTERRUPTS ON 

/SET A TO "WAITING" STATE 

/INDICATING 

/THAT THIS TASK IS WAITING ON IT 



/BDONE MUST TURN INTERRUPTS ON 

/SET B TO "WAITING" STATE 

/INDICATING 

/THAT THIS TASK IS WAITING ON IT 



/BLOCK TASK ON EVENT FLAG WAIT 
/WE'RE BACK - ONE OF THE TWO 
/EVENT FLAGS HAS BEEN POSTED. 
/GO BACK TO FIND OUT WHICH ONE 



9.2.2 WAITX 



Wait for Exactly This Event Flag 



The WAITX ER is similar to the WAITE ER. The exception is that if the 
Event Flag is not FINISHED, the task goes into EORMWT (instead of 
EFWT), and the task's PC in the TSTBL points back to the location 
containing the CAL of this ER. Thus, when the task resumes execution, 
it will re-execute the WAITX. If the EORMWT bit was cleared for some 
reason other than the Posting of the Event Flag in question, the task 
will immediately go back into EORMWT. 

Consequently, control will never flow past this ER unless the Event 
Flag specified is actually posted (see discussion of DERAIL, Section 
9.2.3). If a WAITE had been used and if the task was waiting on 
multiple Event Flags (which can happen using WAITM) , then control 
conceivably could start up after the WAITE ER because some other Event 
Flag, and one that is no longer cared about, was posted. This 
situation can not occur with a WAITX. 



9.2.3 DERAIL - Derail a Task's Execution 

The DERAIL ER modifies the execution of a 
control to a special subroutine of 
exceptional condition. It does not cause 
cleared. 



specified task and transfers 
the task to process some 
any wait bits to get set or 
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Format: TAD TASKNUM 
CAL 

DERAIL 
ADDR 

7^^^mAo sii^^l^tes a "JMS ADDR" for the task whose number is contained 
in TASKNUM (the "derailed" task). ADDR is assumed to be in ?Se same 
tield in which the derailed task is executing. The derailed task's PC 
(from Its Task State Table entry) is stored in ADDR; the PC entry in 
Its Task State Table entry is then set to ADDR+1. Two imoortant 
points concerning the operation of the DERAIL ER are as follows': 

1. The derailed task's AC, Link, and Data Field settings are not 
saved by the DERAIL ER? therefore they must be saved and 
restored by the derail subroutine. In this sense, a derail 
subroutine is very much like an interrupt at the task level. 

2. The contents of the derailed task's Task Flags word are not 
affected by the DERAIL ER. if the derailed task is not 
runnable, the derail subroutine will not be executed until 
the task becomes runnable. 

The DERAIL ER is generally used by a high priority task to signal an 
emergency condition to lower priority tasks. An example would be a 
process-control environment where it is sometimes necessary to abort 
all operations if the room temperature exceeds some critical value. 
This can be checked by a task which measures room temperature every 10 
seconds. It is inefficient and unmodular to include%hutdown code in 
this watchdog task" for all machinery being controlled. A better 
solution is to provide a location to which each equipment-controllinq 
task can be DERAILED in order to shut down its own piece of equipment 
The RTS/8 Power-Fail task uses the DERAIL ER to provide a similar 
facility on power-fail recovery (see Section 4.5), which can be used 
to reinitialize a task. 

Example: 

An example of a DERAIL routine is as follows: 



DENTRY, 





DCA SAVAC 

RAR 

DCA SAVLNK 

RDF 

TAD (CDF 

DCA DFRESET 

CDF CUR 



RESUME, 

DFRESET, 
NORESUME, 



SAVAC , 
SAVLNK, 



TAD SAVLNK 

CLL RAL 

TAD SAVAC 

HLT 

JMP I DENTRY 

CLA CLL 

CDF CUR 

JMP RESTART 







/DERAIL ROUTINE ENTRY POINT 
/SAVE AC 

/SAVE LINK 



/SAVE DATA FIELD 

/HANDLE EMERGENCY CONDITION 

/BRANCH TO 'RESUME' IF YOU WANT 
/TO RESUME WHERE YOU LEFT OFF 
/BRANCH TO 'NORESUME' IF NOT 

/RESTORE LINK 

/RESTORE AC 
/RESTORE DF 
/RESUME (SAME FIELD) 



/RESTART TASK 
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9.2.3.1 Dangers of DERAIL - A task can get into serious trouble if 
it is derailed while already in a derail routine. If this happens, 
the original PC, AC, link, etc., will be lost. There is no simple 
solution. Turning off interrupts in the derail routine may be too 
late to prevent this - the second derail could have already occurred 
before the derail routine was even entered the first time. 

Consequently, a user doing a DERAIL should make sure that not more 
than one DERAL is done at a time. Alternatively, before doing a 
DERAIL, a task can check an interlock flag (which it must maintain) to 
see whether the target task has been derailed or not. The test and 
set of such a flag should be performed with interrupts inhibited. 



9.2.3.2 Restrictions Using DERAIL - If a task is not runnable, 
derailing it will not make it runnable. If the task is in Event Flag 
Wait, it will remain in Event Flag Wait until the event occurs. When 
the Event Flag is POSTed , the task will wake up and begin to run in 
its derail routine rather than in the mainline routine. Thus, 
derailing a task to get it to perform some important job immediately 
may not always work. The task might be in one of the Wait states and 
may not be able to run for some time. For example, if the task were 
in Receive Wait at the time, the derail routine would not run until a 
message came in for that task. 

A partial solution around this restriction is to code the task to be 
derailed so that it always waits on events using WAITX instead of 
WAITE. Then, if the user wants to derail this task, the task is first 
taken out of MSGWT or EORMWT and then derailed. 

An example of the code for this situation is as follows: 

TAD TASKNUM 

CAL 

UNBARG /UNBLOCK THE TASK 

MSGWT! EORMWT /FROM MESSAGE-RELATED WAITS 

TAD TASKNUM 

CAL 

DERAIL 

DENTRY 

This will work because both the RECEIVE and the WAITX Executive 
Requests bump the PC back to the CAL before going into a Wait state. 
Thus, no harm is done if the task is taken out of that wait state for 
an incorrect reason. When the task resumes running at that point, it 
will re-execute the CAL (RECEIVE or WAITX) and go back into the Wait 
state as necessary. This method will not work if the task was in EFWT 
due to a WAITE ER because the task would resume running thinking the 
Event Flag had been posted when in fact it had not. A way to 
circumvent this (other than WAITX) is for the task to do WAITM instead 
of a WAITE, and poll the Event Flag upon waking up. 



9.3 STARTING PARTITIONS AT AN ARBITRARY BOUNDARY 

The advanced user can start a partition at an arbitrary boundary by 
using the following assembly and loading procedure. The example given 
assumes that the partition in which the user writes the nonresident 
portion of the task to run is three pages long (11200-11777) . The 
PALS pseudo-operators FIELD and RELOC are used, and described in 
detail in the OS/8 handbook. 
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FIELD 1 
*1000 
RELOC 1200 



<CODE> 
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/SET FIELD 

/LOAD THIS CODE AT 11000-11577 

/BUT ASSEMBLE IT TO RUN AT 11200-11777 



PAGE 



CODE> 



RELOC 



The assembly, load and save procedures for the code are: 

(ASSEMBLY OF TASK) 



.R PALS 

*TASKX<PARAM . PA , TASKX . PA 



,R ABSLDR 

*TASKX$ (LOADING OF TASK INTO 11000) 

.SAVE DEV TASKX 11000-11577 (SAVING OF TASK-THREE PAGES OF 

CODE) 

T^o.r^^?^": "P°" loading this task, places it into the partition at 
11200, which IS where it was assembled to run. 



9.4 DIRECT REFERENCES TO SYSTEM TABLES 



in the RTS/8 Executive 



A task may directly interrogate locations ^ ...^/ „ -^c^^l...vc 

tables to obtain information about itself or any other task, as long 
as the following two restrictions are observed: 



Due to the interrupt-dr iven nature 
entries may change at any time; th 
be inhibited between the time these 
the time that processing which 
completed. For example, testing th 
a task may show no messages, but 
immediately after the test might al 
to run. This task might send a 
result of the test. To prevent thi 
turned off during and after the tes 



of the system, these table 

erefore, interrupts should 

entries are tested and 

depends on the testing is 

e Message Queue Header for 

an I/O interrupt occurring 

low a higher priority task 

message, invalidating the 

s, interrupts should be 

t. 



System table entries 
Executive Requests. 



may be changed only through RTS/8 



Symbols have been defined in the system parameter table that permit 
symbolic references to be made into these tables symbolically. The 
symbolic expressions which yield the address of the system table 
entries for task N are: 



N+TFTABL 



N"2+MSGTBL 



Task Flags Table entry for task 
N; if zero, task N is runnable. 

Input Message Queue Header for 
task N; if zero, task N has no 
messages in its queue. 
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N"4+TSTABL First word of Task State Table 

Entry for task N. 

N"2+RESTBL First word of Residency Table 

entry for nonresident task N. 

For example, for a task to determine whether it had messages in its 
input queue without issuing a RECEIVE request, the code would be: 

CDF /EXEC TABLES IN FIELD 

lOF /TURN INTERRUPTS OFF 

TAD I (TASK~2+MSGTBL 

SNA CLA /ANY MESSAGES? 

JMP NONE /NO 

ION /YES 

The code at NONE must eventually turn interrupts back on. 
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RTS/8 DISTRIBUTED SOURCE FILES 

The RTS/8 source files included on the distributed tape are: 



Pile Name 


Task Name 


PARAM . PA 




RTS8.PA 




MCR.PA 


MCR 


MCR.PA 


null task 


0S8SUP.PA 


038 


0S8SUP.PA 


0S8F 


PWRF . PA 


PWRF 


CLOCK. PA 


CLOCK 


TTY.PA 


TTY 


LPT. PA 


LPT 


DTA.PA 


DTA 


RK8.PA 


RK8 


RK8E.PA 


RK8 


RF08.PA 


RF08/DF32 


CSA.PA 


CSA 


CSAF.PA 


CSAF 


UDCICS.PA 


UDC/ICS 


RXOIRT.PA 


RX8A 


RXOIRT.PA 


RX8B 


RXOIRT.PA 


RX8C 


RXOIRT.PA 


RX8D 


LTA.PA 


LTA 


SWAP. PA 


SWAPPER 


NULL8A.PA 


NULL8A 


EXIT. PA 


EXIT 



Task Function 

System parameter file with all equates blank. 

Appropriate values should be inserted to create 

specific parameter files. 

RTS/8 Executive 

Monitor Console Routine 

Null task 

OS/8 Support Task 

OS/8 File Support Task 

Power Fail Task 

Clock Handler Task 

Terminal Driver Task 

Line Printer Driver Task 

TC08 DECtape Driver Task 

RK8 Disk Driver Task 

RK8E Disk Driver Task 

RF08/DF32 Fixed-Head Disk Driver 

Task 

Cassette Driver Task 

Cassette File Support Task 

Universal Digital Controller/ 

Industrial Controller Subsystem 

Handler Task 

Floppy Disk Handler (1st controller) 

Floppy Disk Handler (2nd controller) 

Floppy Disk Handler (3rd controller) 

Floppy Disk Handler (4th controller) 

LINCtape Driver Task 

Nonresident Task Swapper 

Null Task for PDP-8A 

Exit Task 
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RTS/8 COMPONENT SIZES 



The following table gives the approximate size and default origins of 
each component of the RTS/8 system. An RTS/8 memory map showing 
default memory allocation is shown in Figure B-1. The modules may be 
placed anywhere in memory at the user's discretion except for RTS8, 
CLOCK and SWAP. Also, certain modules must be placed in field where 
indicated in the tables. 



The following parameters, which are used in Table B-1, are defined 
follows : 

NTASKS = Number of tasks in system 
CLKQLN = Number of entries in clock queue 
MCRSYS = 1 if MCR SYSTAT function desired, else 
MCRCLK = 1 if MCR CLOCK functions desired, else 
KLINES = Number of physical KL8-A lines 

Any fractions from divides should be dropped. 



as 



Table B-1 
RTS/8 Component Sizes 







Number of Pages 




Software 


Default 


Required (1 page 




Component 


Origin 


=128 words) 


Comments 


RTS/8 


00200 


5+NTASKS/18 


Must be in 


Executive 






locations 00200- 
01200. Uses page 
locations 0-3 
and 20-47 and 
auto-index 
register 17. 


Clock Module 


1st page 


3+CLKQLN/22 


Must be in field 




after end of 




0. Uses 




RTS/8 Executive 




auto-index 




(or SWAPPER) 




register 10. 


New 


03400 


3 




Terminal 








Module, V2 








Old 


03400 


2 




Terminal 








Module, VI 









(Continued on next page) 
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Table B-1 (Cont.) 

RTS/8 Component Sizes 



Software 
Component 



Line Printer 
Module 

TC08 DECtape 
Module 

RK8E Disk 
Module 

DF32/RF08 
Module 

LINCtape 

RK8 Disk 
Module 

Power Fail 
Module 

UDC Module 



Cassette 
Module 

Cassette Label 
Support Module 

OS/8 File 
Support Module 



OS/8 Support 
Task 



Default 
Origin 



Monitor Console 
Routine Task 



14400 

14600 

04200 

04400 

15000 
04200 

10200 

10600 

13600 
13000 



04600 if OS/8 
support present, 
otherwise 06200^ 



06200* 



17600 minus 
length (15200 
with all 
options and 
no KL8A support) 



Number of Pages 
Required (1 page 
=128 words) 



2 
1 

l+NTASKS/32 



7-11 depending 
on table space 
desired. 



5+3xMCRCLK+ 
MCRSYS + 
(NTASKS+40)/64, 



Comments 



Uses page 
locations 130-144 



Requires cassette 
handler . 

Requires a mass 
storage handler. 
Must run in field 
0. 

Must run in field 
- requires 8K 
for OS/8 plus a 
mass storage 
handler. Uses 
page locations 
164-177. 

Requires "console" 
terminal handler 
and page 
locations 100-117. 
See Table B-2 for 
more details. 



± 



Moves down by length of KL8A support code if KL8A support present. 

(Continued on next page) 
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Table B-1 (Cont.) 
RTS/8 Component Sizes 



Software 
Component 


Default 
Origin 


Number of Pages 
Required (1 page 
=128 words) 


Comments 


RXOl 
SWAPPER 

EXIT 

NULL8A 

KL8A Support 


13200 

1st page after 

end of RTS/8 

executive 

15000 

13600 

17600 minus 
length 


2 
2 

1/2 

1 

1+KLINES+l 
3 


Must be in 
field 

May relocate 
within a page 

Must be 

in field 0. 



B-3 



RTS/8 COMPONENT SIZES 



RTS/8 SYSTEM MEMORY MAP (Default Memory Allocation) 



PAGES 



1000 



2000 



4000 



5000 



6000 



7000 



200 
400 
600 



FIELD 



RTS8 
(20 tasks) 



"V 



SWAP 



CLOCK 



FIELD 1 



T' 



PWRF 



UDCICS 



TTY,V2 



TTY,V1 



ITrks 
RK8E -•- -r 

Jrfos 



: I 



0S8F 



0S8SUP 



1 



KL8ASR 



RXOIRT 



I 



CSAF 



NULL8A 



LPT 



CSA 



JZ 



J_EXIT 



CTA 



Small 
MCR 



Large 
MCR 



KEY: 



RTS/8 modules may vary in size and placement in memory depending upon the chosen system configuration. 
The following symbology has been chosen to show component default allocation in memory. 



Fixed 



Expandable 



A 

Relocatable 



Relocatable 
and Expandable 



Figure B-1 RTS/8 System Memory Map (Default Memory Allocation) 
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Table B-2 
MCR Component Size 





If less than 


34(octal) tasks 


If 34(octal) 


or more tasks 


NO SYSTAT 
NO CLOCK 


LENGTH: 
DEF ORIG: 
IF NONRS: 
PART: 


5 pages 
6400 
6200 
6400-7377 


LENGTH: 

ORIG: 

IF NONRS: 

PART: 


6 pages 
6200 
6200 
6400-7577 


SYSTAT 
NO CLOCK 


LENGTH: 

ORIG: 

IF NONRS: 

PART: 


6 pages 
6200 
6200 
6400-7577 


LENGTH: 

ORIG: 

IF NONRS: 

PART: 


7 pages 
6000 
5600 
6000-7377 


CLOCK 

NO SYSTAT 


LENGTH: 

ORIG: 

IF NONRS: 

PART: 


10 pages 
5600 
5600 
6000-7577 


LENGTH: 

ORIG: 

IF NONRS: 

PART: 


11 pages 
5400 
5200 
5400-7377 


SYSTAT 
CLOCK 


LENGTH: 

ORIG: 

IF NONRS: 

PART: 


11 pages 
5400 
5200 
5400-7377 


LENGTH: 
DEF ORIG: 
IF NONRS: 
PART: 


12 pages 
5200 
5200 
5400-7577 
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RTS/8 FLOWCHARTS 



This appendix contains RTS/8 flowcharts that graphically show RTS/8 
system operation. 
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SAVE AC IN 
ACARG 



INHIBIT TASK- 
SWITCHING. 
CLEAR RESCAN 
FLAG 



ION 



SAVE CALLING 
FIELD 



SAVE RETURN 
ADDRESS 



GET FUNCTION 
CODE 



SAVE 
COMMAND 




Cain 


ig Sequence: 


p-1 


TAD VAL 


p 


CAL 


p+1 


FUNCTION CODE 


P+2 


ARG1 


p+3 


AGR2 lor return) 


p+4 


RETURN 


CAL 


= JMS 20 


Thru 


Current Field: 


20 





21 


CDF CUR 


22 


CIFO 


23 


CMPCALIOF (field 0| 


24 


DSPOST 


25 


XWAITIVI 



Function 
Code 



SW 

SW designates an operation that is performed 
only when using nonresident operations. 

EAE designates an operation that is perfornned 
only when the Extended Arithmetic Element 
is used. 




1 
2 
3 
4 
5 
6 
7 

10 

11 

12 

13 

14 



EXECUTE 
DISPATCH JUMP 
THRU COMMAND 
TABLE. IGNORE 
FREE BIT 



JMP I .+FUNC+1 



XSEND 



XRECEIV 



XRUN 



XSUSPND 



XPOST 



XSKPINS 



XDERAL 



XBLKARG 



XSENDW 



XUIMBARG 



XTSTOP 



XWAITX 




Pg. C-4 
Pg. C-11 
Pg. C-7 
Pg. C-20 
Pg. C-20 
Pg. C-14 
Pg. C-15 
Pg. C-16 
Pg. C-13 
Pg. C-4 
Pg. C-12 
Pg. C-8 
Pg. C-7 
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SETUP 
RETURN FIELD 



Cannot 
Happen 


TSWFLG=1 . 


TASKSWITCHING 
NEEDS RESCAN 
\„^ ? y^ 


Yes 
\TSWFLG = -1 


KEEP TASK- 
SWITCHING 


< 


y^ 


INHIBITED 








' 



TSWFLG=0 
No 



ALLOW TASK- 
SWITCHING 
JMP I 20 
RETURN TO 
CALLING TASK 
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SEND 
SENDW 



( XSENDW ) 



SET 
WAIT FLAG 



Yes 



I MSEFWT J- 



BACKUP RETURN 

TOCAL 

ADDRESS 



AC= 

MESSAGE 

ADDRESS 





CLEAR 
WAIT FLAG 



GET TASK 
NUMBER TO 
SEND MSG TO 



GET MESSAGE 
ADDRESS 



Calling Sequence: 

P CAL 

P+1 SEND (W) 

P+2 TASK # (Sending to) 

P+3 MSGADR 

P+4 RETURN 






Initial Values 


Becdmes 


p 


MSGADR, 0000 


Sending Task =i 


p+1 


0000 


CDF to next 
msg, if any 


p+2 


0000 


Addr of next 
msg (0 if none) 


p+3 


Start of Message 



BUMP RETURN 

TO 

CAL + 4 



FIND RECEIV 
INGTASK='s 
ENTRY IN 
MSGTBL 
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GET DATA 
FIELD OF 
MESSAGE 



•i ADDTOG ) Pg 
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( ADOTOQ 1 



GET FIRST 
QUEUE WORD 
(CDF TO NEXT) 




FIND NEXT 
MESSAGE IN 
QUEUE 



PUT CDF TO 
MSG ANDPCOF 
MSG INTO 
QUEUE WORDS 




ADDTOQ j Pg. C-5 



lOF 



GET TASK # 
TO SEND 
MESSAGE TO 



T 

( to page C-6 j 
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D 
O 

N 


T 

T 

U 
C 
H 



T 
H 
I 
S 

C 

D 

E 



( MSGCDF j- 



Link indicates whether 

a new tasl< should be 

run or not. 

The link status will be 

checked later on in 

POSTEX. 



( from page C-5 ] 



FREE MSG WAIT 
AND/OR EVENT 
WAIT BITS IN 
STATUS TABLE 



L=1 IF RECEIV- 
ING TASK IS 
RUNNABLE&OF 
HIGHER PRIORITY 
THAN SENDER; 
L=OIF NOT 



STORE SENDING 
TASK NUMBER 
IN MSG HEADER 



STORE CDF TO 
NEXT MSG IN 
MSGHDR 



Via call to FREEJ 



This will be tested if 
this CAL was a SEND and 
notaSENDW. 



-0 if none 



STORE PC OF 
NEXT MSG IN 
MSGHDR 



-0 if none 




Message is now 
linked into the 
message queue. 



No 
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I XWAITE ) 



I XWAITX ) 



WAITE 
WAITX 













CLEAR 
ACARG 


SET ACARG 
TO-1 


















\ 






Enter Here From 
SENDorSENDW 




GET ADDRESS 
OF EVENT 

FLAG 




( \ 












' 




ACARG # -1 


SAVE ADDRESS 
OF EVENT FLAG 












IGF 





Calling Sequence: 



P 

p+1 
p+2 
p+3 



CAL 

WAITE 

EVENT FLAG ADDR 

RETURN 




Restart caller if 
TASKSW allows 
Pg. C-3 



EVTFLG = 

4000 + TASK NO 



Give it waiting status 



Yes 



PUSH PC BACK 
TO POINT 
TO CAL 




AC=EORIVIWT 



AC=EFWT 



{ TSWAIT j 



Pg. C-8 




Store Event Flag Wait 
in Flag Table 



Jump with link clear 
(tested at TSTOPI 
Pg. C-8 
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Wait for message. 

Enter here from RECEIVE. 



BACKUP 
CALLING PC 
TO DO CALX 
AGAIN 



I TSWAIT y 
I TSWATX |_ 



SETLINK 
AC ' MSGWT 



Message Wait Status 



SAVE AC 
IN MASK 



STORE IN 
TASK #'s 
FLAG TABLE 
ENTRY 



ION 



Interrupts were off here 
if we came from XWAITE. 




Yes 




CLEAR TASK AC 



No 



SAVE AC IN 
ACAR6 



GET TASK 
NUMBER'S 
ENTRY IN 
STATUS TABLE 



( to page C-9 j 
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Schedule next 
runnable task 
{start scan 
from top) 



( FINDJL j- 



( from page C-8 ) 



SAVE RESTART 
FLAGS, PC, AC 



SAVE MQ 



FREE PARTITION 
IN FREE BIT 
WAS SET IN 
COMMAND 



SW 



TASK#= 1 




RTS/8 Scheduler 



ENABLE 
TASKSWITCHING 



SET 'MACHINE 
STATUS UNIM- 
PORTANT' 
FLAG 



GET TASK #'s 
ENTRY IN 
FLAG TABLE 




Interrupts temporarily 
inhibited here. 



Yes 




STARTJ 



Pg. C-10 



BUMP TASK 
NUMBER 



Note no end of table 
check - there must be 
a runnable task. (Null 
task is always runnable.} 
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Here from FINDJ (Scheduler) 
Found a runnable task 



SAVE OLD 
STATUS IN TEMP 
LOGS OF INTER- 
RUPT ROUTINE 



Interrupt 

Dismiss 

Code 

This is tested on an 
8/E or 8/A only 




Yes 



-H USERSK I 



Pg. c-17 



SWEEP OLD 
STATUS INTO 
OF, IF, AC, PC, 
ETC. 



RESTORE MQ 



EAE 



ION 



JMPI 

RETURN FROM 
INTERRUPT 
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RECEIV 




Calling 


Sequence: 


p-1 


TAD ARG 


P 


CAL 


p+1 


RECEIV 


p+2 


MADDR.O 


p+3 


RETURN 



GET ENTRY 
IN MESSAGE 
QUEUE 



GET FIRST 
WORD OF 
QUEUE ENTRY 




Yes 
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No 



ADVANCE TO 
NEXT MESSAGE 
ON THE QUEUE 




No 




UNLINK THIS 
MESSAGE FROM 




I ' 


THE QUEUE 










Yes 




STORE ADDR OF 
MESSAGE IN 
CAL + 2 














AC = CDF 
TO MESSAGE 
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UNBARG 




GET BIT MASK 
FROM ARC. 
LIST 



lOF 



CLEAR MASK 
BITS IN FLAG 
TABLE 




ION 




Call FREEJ 

L=1 if clearing mask 
bits makes task 
runnable and it is 
higher priority; L=0 
otherwise. 
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BLKARG 





p-1 


TAD TASK 


p 


CAL 


p+1 


BLKARG 


P+2 


WAITBITS 


p+3 


RETURN 



GET WAIT BITS 
FROM ARG, 
LIST 




Pg. C-8 



SET MASK BITS 
IN FLAG TABLE 
ENTRY OF SPEC 
IFIEDTASK 



( EXRET j Pg 
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( XPOST 1 



SAVE ORIGINAL 
EVENT FLAG 



Calling 


Sequence: 


P-1 


TAD EFPTR 


P 


CAL 


P+1 


POST 


p+2 


ECDF, CDF EFFLD 


p+3 


RETURN 



CLEAR EVENT 
FLAG 





EXRET I Pg. C3 



GET WAITING 
TASK'S* FROM 
LOW ORDER BITS 
OF THE OLD 
FLAG 



CLEAR BOTH 
EVENT FLAG 
WAIT AND 
EVENT OR MSG 
WAIT 




Pg. C-12 
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SKPINS 




Calling 


Sequence: 


P 


CAL 


P+1 


SKPINS 


P+2 


MODULE ADDR 


p+3 


RETURN 



GET FIRST 
MODULE WORD 




No 



ALREADY IN 
THE SKIP 
CHAIN!!! 



Yes 



PUTDISMIS 
ROUTINE ADDR 
IN 1st WORD 



f EXRET J Pg.C-3 



PUTCDF, CIF 
OF DISMIS IN 

2nd WORD 



PUT MODULE 
ADDRESS AND 
CDF, CIF IN 
LAST MODULE 
OF INTERRUPT 
SKIP CHAIN 
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DERAIL 




GET TASK #-5 
STATUS TABLE 
POINTER 



Calli 


ng Sequence: 


p-1 


TAD TASK* 


P 


CAL 


P+1 


DERAIL 


P+2 


SUBROUTINE 


p+3 


RETURN 



STORE 
RESTART PC 
INSUBR 



STORE SUBR+1 
IN RESTART 
PC 
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If present 



USER-INSERTED 
SKIPS FOR ANY 
CRUCIAL DEVICES 




Yes 




Yes 



If present 




Yes 



SETUP LOCO 
FOR POWER 
FAIL RESTART 



r V' 

( POWER-UP ) 

V RESTART y 



AC = POWER-UP 
EVENT FLAG 
ADDRESS 
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POSTDS 




Come here from user 
issuing POSTDS 



p-3 
p-2 

p-1 
P 



CDFEFFLD 
TAD EFPTR 
CIFO 
POSTDS 



Pg. C-10 



SAVE THE OLD 
EVENT FLAG 
VALUE 



ZERO EVENT 
FLAG 



Run the waiting task if 
its flag word is now zero 
and it is higher priority 
than the current user. 
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No 



from page C-18 




Yes 



SAVE CURRENT 
TASK'S PC, AC 
IN ITS STATUS 
TABLE ENTRY 



SAVE 
TASK'S MQ 



EAE 



PREPARE TO 
START NEW 
TASK 



SETRESCAN 
FLAG 
CTSWFLG = -1 



r DISMIS J Pg. C-10 




Pg. C-9 
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AC= RUNWT 




Run Wait 



Pg. C-12 

Go and set 
the flag bits 



Calling 


Seq 


uence: 


p-1 




TAD TASK 


P 




CAL 


p+1 




RUN 


P+2 




RETURN 



SUSPND 




Calli 


ng Sequence: 


P-1 


TAD TASK 


P 


CAL 


P+1 


SUSPND 


p+2 


RETURN 
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WAITM 



SAVE AC 

IN 'COMMAND' 



SW 



CLEAR AC, L 



FAKE A GAL 



DISABLE 

TASK 

SWITCHING 



PUT WAIT 
BITS IN AC 



TSWAIT 
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FINDJ 



RTS/8 SCHEDULER 
FIND A TASK TO RUN 



ENABLE 

TASK 

SWITCHING 



GET SET TO 
EXAMINE 
FIRST TASK 



ZERO SAVE 
STATE FLAG 



ION 



BUMP TO 
NEXT TASK 



lOF 



GET 

TASK FLAGS 



Yes 



'ANY 
BLOCKING 
[_BITS OTHER THAN^ 
NRWT 



CONTINUE 
NEXT PAGE 
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FROM 
PREVIOUS PAGE 




PUT TASK 
INTOSWPWT 



SW 



TAKE SWAPPER 
OUT OF RUNWT 



SW 



FINDJ 



STARTS 



Start task 
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APPENDIX D 
RTS/8 ASSEMBLY ERROR MESSAGES 



Certain user errors are caught at assembly time. They produce 
standard PAL8 error diagnostics on the terminal of the form 

IC 

US tag 

IC 

where the tag specified indicates the type of error as described 
below. 



Tag 



Module 



Possible Error 



MCRBLK 



MCR.PA 



SYSERR 



TBLERR 



CURBIG 



RATERR 



TODERR 



several 



RTS8.PA 



PARAM . PA 



CLOCK. PA 



CLOCK. PA 



MCR was declared nonresident (MCRPRT 
defined) and MCR origin was incorrectly 
a multiple of 400. Nonresident portion 
of MCR is second page which must start 
on a block boundary. 

Fix: Redefine MCRORG. 

System error; should not occur unless 
user modified RTS/8 sources. 

Fix: See comments on source line 
which generated the error. 

Internal Executive tables were generated 
incorrectly. See source. 

User task specified a value for CUR 
which was larger than HGHFLD. 

Fix: Redefine CUR. 

HERTZ is not a multiple of SHERTZ. 

Fix: Redefine HERTZ or SHERTZ in 
parameter file. 

SHERTZ is too large. SHERTZ must be 
less than 192 (decimal). 

Fix: Redefine SHERTZ in 
parameter file. 
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Tag 



Module 



Possible Error 



N0KL8A 



KL8ASR.PA The symbol KL8A was not defined in the 
parameter file. 



KLOERR. 



HITMON, 



NOSWAP 



SWPRIO 



FLDERR 



CURERR 



KLSASR.PA 



KL8ASR.PA 



PA RAM. PA 



PARAM . PA 



PARAM . PA 



PARAM . PA 



Fix: Set symbol KL8A in parameter file 
equal to number of physical 
KL8-A's present. 

The symbol KL8A was set equal to yet 
the file KLSASR.PA was assembled. 

Fix: Do not assemble KL8ASR.PA if KL8-A 
support is not desired or redefine 
KL8A in the parameter file. 

The KL8-A service overlaid location 7600 
in field 0. Ignore this error if you do 
not want to preserve OS/8 resident code. 

Fix: Redefine KL8ACT in parameter file. 

A nonresident task was assembled in a 
system with no swapper. 

Fix: Define SWAPPER in parameter file 
or undefine PARTNO in user task. 

A nonresident task was given higher 
priority than the swapper. 

Fix: Change priority of swapper or user 
task. 

Some parameter representing a field 
number times 10 was not in the correct 
form (e.g. HGHFLD, MCRFLD, etc.) 

Fix: Correct value of parameter in 
parameter file. 

One of the symbols CUR, CUR2, or CUR3 
was not of the proper form. 

Fix: Correct value in user task to 10 
times field of task. 
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APPENDIX E 
EXECUTIVE INTERNAL TASK TABLES 



The Executive uses five internal tables to maintain information about 
the tasks in the system. Each task's task number is used as an index 
into the first four tables to retrieve and update information for that 
task. The internal tables are as follows: 

1. The Task State Table (TSTABL) - contains 4-word entries 
holding the most recent contents of CPU registers for each 
task as follows: 

Word 1 - contains the link (bit 0) 

the Greater Than Flag (bit 1) -if flag 

exists on machine being used 

the User Mode Flag (bit 5) -if flag 

exists on machine being used 

the Instruction Field (bits 6-8) 

the Data Field (bits 9-11) 

Word 2 - contains the contents of the Program Counter 
(PC) 

Word 3 - contains the contents of the Accumulator (AC) 

Word 4 - contains the contents of the Multiplier 

Quotient (MQ) register if the system has been 
assembled to save the MQ, 

Whenever the system executes a task, it loads the contents of 
the task's Task State Table entries into the corresponding 
CPU registers. Whenever a task stops executing, its Task 
State Table entries are set to the new contents of these 
registers. The Task State Table is located after the Message 
Table, that is, at location NTASKS+2"2+MSGTBL-4 in field 0, 

Example: 

Consider the following TSTABL entries for a task. 

4012 
3376 
1234 
0211 

The task is interrupted just as it is about to execute the 
instruction at location 3376 (entry 2) of field 1 (bits 6-8 
of entry 1). At this point, the contents of the CPU 
registers for this task are entered in the TSTABL. The AC is 
1234 (entry 3) , and the MQ is 0211 (entry 4) . The link is 
set (bit of entry 1) , and the data field is 2 (bits 9-11 of 
entry 1) . 
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The Task Flags Table (TFTABL) - contains 1-word entries 
holding various flags (bits) for each task to determine 
whether the task is runnable. A task is runnable only if its 
Task Flags Table entry contains zero. Each flag (bit) which 
is set in a nonzero word indicates a reason why the task 
cannot run. The currently defined flags, if set, and their 
meanings are as follows: 



Octal 



Symbolic 



Meaning 



4000 



2000 



1000 



0400 



0200 



0100 



NONRWT 



EFWT 



RUNWT 



SWPWT 



EORMWT 



USERWT 



Nonresident Wait - This task 
because it is not in memory. 



cannot 



run 



Event Flag Wait - This task is waiting for an 
Event Flag (which contains a WAITING value 
corresponding to this task) to be POSTed. 

Run Wait - This task is waiting for a RUN ER 
to be executed with its number in the AC, or 
for the operator to type "REquest task" to 
the Monitor Console Routine (see Chapter 6) . 

Swap Wait - This task cannot run because it 
is in the process of being brought into 
memory. 

Event or Message Wait - This task is waiting 
for an Event Flag to be set or a message to 
arrive, whichever happens first. 

User Wait - This bit is reserved for use by 
user-written tasks. RTS/8 does not use this 
bit. 



0040 



ENABWT 



0020 

0010 
0001 



MSGWT 

NETWT 
DNEWT 



Enable Wait - This task is waiting to be 
Enabled. Use of this bit is restricted to 
the Monitor Console Routine for the "ENable 
task" and "Disable task" commands. (See 
Chapter 6) . 

Message Wait - This task is waiting to be 
sent a message. 



Reserved for future use. 

Does Not Exist Wait - This 
because it is nonexistent. 



task cannot run 



0000 



Task is runnable, 



The Task Flags Table is located after the Task State Table, 
that is, at location NTASKS + 2''4+TSTABL-l in field 0. 

Examples : 

1. If the TFTABL entry for a task is 

1000 

the task is waiting to run. 
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2. If the TFTABL entry for a task is 

0440 

the task was disabled from running by the operator at the 
MCR terminal while the nonresident portion of the task 
was waiting to be swapped in. 

3. If the TFTABL for a task is 

0000 

the task is runnable. However, this task may not run if 
a task of higher priority has precedence. 

The Task Input Message Queue Header Table (MSGTBL) - contains 
2-word entries that represent the "head" (start) of the input 
message queue for each task: 

Word 1 - if zero, there are no messages in the queue; 
if non-zero, the word is a CDF to the field of 
the first message in the queue. 

Word 2 - if word 1 was not zero, this word is a pointer 
to the address of the first message in the 
queue . 

The Message Table is located at the end of the RTS/8 
Executive in field 0. 

Example: 

Consider the following MSGTBL entries for a task. 

6211 
2044 

Since the first entry is a nonzero, there are messages in the 
input queue waiting for this task to receive them. The first 
entry is a CDF instruction to field 1. The second entry is a 
pointer indicating that the first message begins at location 
2044 in field 1. 

The Residency Table (RESTBL) - contains 2-word entries for 
each nonresident task. 

Word 1 - contains a pointer to the task's Partition 
Table entry in bits through 9. Bit 10 is set 
if a task is checkpointable, and bit 11 is set 
if a task is writeable. Checkpointable and 
writeable tasks are defined in Section 5.1. 

Word 2 - contains the absolute block address (plus 1 to 
allow for the core control block) of the task's 
core image on the swap device. 

The Residency Table is located after the Task Flags Table, 
that is, at location TFTABL+NTASKS+2 in field 0. 
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Example : 

Consider the following RESTBL entries for a task. 

1611 
0124 

This task has a nonresident portion. The 4-word partition 

table entry used by this task begins at location 1610. The 

task is not checkpointable (bit 10 of entry 1 is a 0) , but it 
is writeable (bit 11 of entry 1 is a 1) . 

The disk-resident portion of this task begins at block 124 on 
the swap device. (The save image begins at block 123.) 

5. The Partition Table (PARTBL) - contains a 4-word entry for 
each partition. It is indexed into via a partition number. 

Word 1 - contains the length (size) in bits 1-5 and 
field (bits 6-8) argument of the mass storage 
device driver call that reads an occupant into 
the partition with the "WRITE" bit set. Bit 11 
of this word is the partition busy flag. 

Word 2 - contains the memory address of the partition. 

Word 3 - contains a pointer to word 1 of the occupant's 
RESTBL entry. 

Word 4 - unused 

The Partition Table must begin at an address that is a 
multiple of four. It is located after the Residency Table, 
i.e., at location NTASKS-SWAPPER"2+RESTBL+3&7774 in field 0. 

Example : 

Consider the following PARTBL entries for a particular 
partition . 

5421 
1400 
1553 
0000 

This partition is currently in use (bit 11 of entry 1 is a 1) 
by a task whose 2-word RESTBL entry begins at location 1553 
(entry 3) . The partition begins at location 1400 (entry 2) 
of field 2 (bits 6-8 of entry 1) . The partition is 14 
(octal) pages long (bits 1-5 of entry 1) . 

Figure E-1 summarizes the internal task table structure of the 
Executive. The Residency Table and Partition Table are optional in 
that they are used only when nonresident tasks are employed. The 
exact location of these tables in memory depends on the number of 
tasks and other parameters in the parameter file. They can be found 
for a particular assembly under the "System Locations:" heading at the 
end of the parameter file assembly listing. 
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M 
I 
U1 



Word 1 



Word 2 



Word 3 



Word 4 



TASK STATE 
TABLE (TSTABLI 



Instruction 

Field 

Link GT UM (IF) 

15 6-8 



Data 

Field 

(DF) 
9-11 



Contents of Program 
Counter (PC) 



Contents of Accunnulator 
(AC) 



Contents of Multiplier 
Quotient (MQ) 



• Upon task execution, TSTABL 
loaded into corresponding CPU 
registers 

• Upon task interruption, TSTABL 
entry set to new contents of CPU 
registers 



TASK FLAGS 
TABLE (TFTABL) 



Bits determine if task is 
runnable 



• Task runnable if entry 
contains zero 



TASK INPUT MESSAGE 
QUEUE HEADER (MSGTBL) 



If zero, no messages in queue, if 
nonzero, word is CDF to tfie field 
of first message 



If nonzero, this word is pointer 
to the first message in the queue 



• Represents the "head" of the 
input message queue for each 
task 



RESIDENCY 
TABLE (RESTBLI 



Contains pointer to task PARTBL 
entry in bits 0-9; bit 10 check- 
pointable; bit 11 writeable 



Block address plus 1 of the task's 
core image on swap device 



• Bit 10 of word 1 is set if task 
checkpointable 



• Bit 1 1 of word 1 is set if task 
writable 



PARTITION 
TABLE (PARTBL) 



Contains the Length (size) and 
Field argument (bits 1-8) of the 
mass storage device driver call 
that reads occupant into partition 
with 'write' bit set (bit 0). 



Contains starting address of 
the partition 



Contains pointer to word 1 of 
the occupant's RESTBL entry 



• Bit is always set (write) 

• Bit 1 1 of word 1 is the 
partition memory flag 



M 
X 

ra 
n 
a 

1-3 

M 
< 



z 

M 
» 

> 
f 

> 

> 
CO 
f 

w 
m 



Figure E-1 Executive Internal Task Table Structure 



GLOSSARY 



Accumulator The register in which the arithmetic 

operations are performed (abbreviated AC) . 

Analog Representation of information by continuous 

variables . 

Analog Channel An UDC/ICS functional device. 



a 



Argument A variable or constant which is given in the 

call of a subroutine as information to it; a 
variable upon whose value the value of a 
function depends; the known reference factor 
necessary to find an item in a table or array 
(i.e. the index) . 

Assembler A program which translates symbolic op-codes 

into machine language and assigns memory 
locations for variables and constants. 

Auto-index register Whenever one of the absolute locations from 

0010 through 0017 in any memory field is 
addressed indirectly, the contents of that 
location is incremented by one, rewritten in 
the same location, and used as the effective 
address of the current instruction. 

Auto-restart The ability to start the CPU automatically on 

power -up. 

Baud A unit of measure of data flow (one bit per 

second) . 

Bit A binary digit (each PDP-8 word is composed 

of 12 bits) . 

Bit Map A method of keeping track of used and unused 

entities by assigning one bit in a table to 
each entity. 

Block A set of consecutive machine words, 

characters or digits handled as a unit, 
particularly with reference to input and 
output; an OS/8 block is 400 octal 
contiguous words; also to inhibit a process 
from continuing. 

Block Gap The blank space between blocks on a recording 

medium. 

Blocking Bits Bits in an RTS/8 Monitor Table which specify 

why a given task is blocked. 

Byte A group of binary digits usually operated 

upon as a unit. 

Cassette A magnetic tape device used for program and 

data storage. 
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Central Processing Unit The unit of a computing system that includes 

the circuits controlling the interpretation 
and execution of instructions (abbreviated 

Checkpointable Task A task is checkpointable if it may be swapped 

out of memory automatically, without its 
consent, to make room for higher priority 
tasks . 



Clear 



To erase the contents of a storage location 
by replacing the contents, normally with 
zeros . 



'^^°^^ A time keeping or measuring device within the 

computer system; provides periodic 
interrupts. 

Communication Region Locations 20-27 of every field, used to 

simplify passing executive request across 
field boundaries. 

Compute Bound Requiring extensive (or total) use of the CPU 

relative to other hardware elements (such as 
I/O devices) . 

Configuration The number and types of hardware present on a 

system. 

Contact Channel A UDC/ICS functional device. 

Contiguous Code which resides in memory immediately 

adjacent to other sections of code. 

Controller The circuitry that controls a device. 

Core Image File A file in core image format (i.e., a 

'picture' of core); also known as SAVE file. 

Core Storage The main high-speed storage of a computer in 

which binary data is represented by the 
switching polarity of magnetic cores. 

Counter Channel A UDC/ICS functional device. 

CPU Registers High-speed circuitry used to store 

information affecting the operation of the 
CPU (e.g. , PC, IF, DF) . 

^^^^ A general term used to denote any or all 

facts, numbers, letters and symbols. It 
connotes basic elements of information which 
can be processed or produced by computer. 

Data Field a 3-bit register which determines the memory 

field from which operands are taken in 
indirectly addressed instructions 
(abbreviated DF) . 

°^t>"g To detect, locate and correct mistakes in a 

program. 
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Deferred Actions 

Deferred Requests 

Derail 

Device Codes 

Device Status Register 

Digital 

Digital Channel 

Driver 

Dynamic 

Entry Point 
Event Flag 

Executive 

Executive Requests 
Field 
File Gap 

Functional Devices 

Gain 

Generic Codes 

Handler 
I/O Bound 



Actions which are considered low-priority and 
are not performed until higher-priority 
actions are serviced. 

Requests which are considered low-priority 
and are serviced after high-priority 
requests . 

To transfer control or execution of a 
specified task to a subroutine. 

Numbers assigned to each device in the 
system. 

A register which contains the current status 
of a device. 

Representation of information by discrete 
units. 

A UDC/ICS functional device. 

See Handler. 

Pertaining to a quantity that is affected by 
some condition (such as time) and is 
therefore relative to the condition; also 
refers to features at system run-time. 

The location in a routine to which control 
can be transferred and execution begun. 

The location which contains the status of an 
event (event being either a result of some 
operation, or a physical occurrence) . 

The program which controls the execution of 
other programs or routines. 

Means of communication between tasks and the 
RTS/8 Executive. 

A division of memory on a PDP-8 computer 
referring to a 4K section of memory. 

A fixed length of blank tape separating files 
on a recording medium; generally several 
times the size of a block gap. 

The devices available for use under the 
UDC/ICS handler. 

An increase in signal power. 

Codes used to identify which type of UDC/ICS 
functional device caused an interrupt and to 
direct program control to service routines. 

A routine which is designed to control the 
operation of a device. 

A condition in which a process is performing 
much I/O but using very little CPU time. 
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Indirect Address 
Initialization Code 

Input Buffer 
Instruction Field 

Interactive 
Interface 

Interlock Scheme 

Interrupt 



An address in a computer instruction which 
indicates a location where the address of the 
referenced operand is to be found. 

Code which sets counters, switches, and 
addresses to zero or other starting values at 
the beginning of or at prescribed points in a 
computer routine. 

A section of memory used for storage of input 
data • 

A register which holds the contents 
determining from which field the operand of a 
directly addressed instruction should be 
taken (abbreviated IF) . 

Highly responsive to real-world inputs. 

The common hardware and/or software boundary 
between two devices or systems. 

Arranging the control of devices so that 
their operation is interdependent. 

A break in execution caused by some external 
event; execution is usually resumed at a 
later time. 

Interrupt Processing Module 

A routine which acts upon the external event 
which caused an interrupt. 



Interval Queue 

Line-frequency Clock 
Link 

Logical OR 
Loop 

Mass Storage Device 

Master Parameter File 

Memory Address 



A list of actions to perform, each 

accompanied by the interval of time which is 

to elapse from the previous action to the 
current one. 

A clock whose ticking occurs at a multiple of 
the power line frequency. 

A one-bit register in the PDP-8; an address 
pointer generated automatically by the PALS 
assembler to indirectly address an off-page 
symbol . 

A logical function of two or more inputs 
which is true whenever either input is true. 

A sequence of instructions that is executed 
repeatedly until a terminal condition 
prevails . 

A device such as disk or DECtape which stores 
large amounts of data readily accessible to 
the central processing unit. 

A file included in the distributed sources of 
RTS/8 which the user can edit to indicate 
parameters specific to his system 
configuration. 

A register which holds the address specified 
by a memory reference instruction. 
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Message A contiguous area of memory which contains 

information about execution of tasks. 

Message-driven An RTS/8 task is called message-driven if it 

only executes in response to messages 
received from other tasks. 

Mnemonic Alphabetic representation of a function or 

octal machine instruction. 

Module A routine which handles a particular 

function. 

Monitor Console Routine The Monitor routine which provides the user 

with functions which allow him to control, 
inspect, and debug his system. 

Multiplier Quotient A 12-bit register used in conjunction with 

the accumulator to perform mathematical 
operations (abbreviated MQ) . 

Multi-programming Two or more programs (tasks) in memory at the 

same time which execute alternately depending 
on the current state of the system. 

Nonresident Task A nonresident task is a task or a portion of 

a task that is swapped into memory when it 
becomes executable. 

No-op No operation occurs; control proceeds to the 

next instruction in sequence. 

/ 

Null Characters Characters with ASCII code 000. 

Overflow A condition that occurs when a mathematical 

operation yields a result whose magnitude is 
greater than the data presentation is capable 
of storing. 

Pack To conserve memory by combining information. 

Page A 128-word (decimal) section of PDP-8 core 

memory beginning at an address which is a 
multiple of 200(octal). 

Parameter file A file used to record arguments which may be 

assigned different values. 

Parity Bit A bit which indicates whether the total 

number of binary one digits in a word is even 
or odd. 

Pointer A word containing the address of another word 

in memory. 

Post To post an Event Flag means to set it to a 

FINISHED state via an RTS/8 Executive 
Request . 

Posted One of the states of an event flag, 

indicating that the event is complete; same 
as "FINISHED". 
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Power-fail 
Priority Scheme 

Program Counter 

Prompting Character 

Queue 

Ready Flag 
Real-time System 



Receiver 



Record 



Record Header Area 
Ring-buffer 

Scheduling 

Sender 

Sign Bit 
Simulate 

Skip Chain 

State 
Status 



An interruption of power to the computer. 

A scheme by which certain operations or the 
execution of a set of instructions is given 
preference over other operations. 

A register which contains the address of the 
next instruction to be executed (abbreviated 
PC) . 

A character which prints on the console 
terminal and cues the user to perform some 
action. 

A waiting list (e.g., a queue of programs 
waiting for processing time) . 

A bit which a device controller sets when it 
is ready to accept commands from the CPU. 

A system in which computation is performed 
while a related physical process is occurring 
so that the results of the computation can be 
used in guiding or measuring the physical 
process . 

The task which has received a message from 
another task (sender). 

A collection of related items of data treated 
as a unit. 

An area of at least 40(octal) words in length 
which contains information necessary to 
perform cassette operations. 

A storage area for data accessed on a 
first-in, first-out basis. Similar to Queue, 
but usually involves storage of character 
codes . 

The operation of sharing resources among 
computing tasks. 

The task which has sent a message to another 
task (receiver) . 

The bit which contains the sign of a number. 

To represent the function of a device, system 
or program with another device, system or 
program. 

An instruction sequence which determines the 
source of an interrupt request on a PDP-8; 
contains one or more tests for each possible 
(hardware) interrupt condition. 

A complete description of the condition of a 
piece of hardware or of a task. 

That portion of the state which other devices 
or tasks might be interested in. 
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Subchannel 

Suspend 

Symbols 

Synchronization 

System Ticks 

Task 



Task Flags Table 



One of the 4 channels of a UDC/ICS analog 
functional device. 

To temporarily halt execution of a task while 
another task of higher priority runs. 

Names which can be assigned values or which 
can be used to indicate specific locations in 
a program. 

A means of coordinating tasks (through event 
flags) so that one task executes while others 
wait . 

An RTS/8 convention designed to obviate the 
tasks in the system from knowing the 
frequency of the clock. 

A task is a routine which performs a specific 
function. A task may be "resident" or 
"nonresident". A resident task is 
permanently located in memory. A nonresident 
task is loaded into memory as it is needed 
and can be overlaid after its completion. 

A table of 1-word entries in the RTS/8 
Executive whose contents determine whether or 
not a task is runnable. 



Task Input Message Queue 
Header Table 



Task Number 



Task State Table 



Task Switching 



Terminal 



Utilities 



Word 



A table of 2-word entries which represent the 
head of the input message queue for each 
task. 

A unique number between 1 and 63 (decimal) 
assigned to each task in an RTS/8 system. 

A table of 4-word entries which contains the 
ost recent contents of CPU registers for 
.ach task. 

The act of stopping execution of one task and 
ontinuing execution of another from the 
point that it was last stopped. 

A peripheral device in a system through which 
data can enter or leave the computer . 

Routines to perform non-Monitor related 
functions . 

In the PDP-8, a 12-bit unit of data which may 
be stored in one addressable location. 
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INDEX 



ALTMODE, 4-4, 5-1 

Analog input UDC/ICS operation, 

4-26 
Analog output UDC/ICS operation, 

4-25 
Arbitrary boundaries, 9-7 
Assembling nonresident tasks, 

7-6 
Assembling tasks, 6-5, 8-11 
Assembly, 

nonresident tasks, 7-8 
Assembly error messages, D-1 
Assembly parameters, UDC/ICS, 

4-31 

Batch control, 

nonresident tasks, 7-8 
Batch stream, 6-6, 6-8 
BLKARG ER, 3-6 
Buffers, 7-6 

CAL instruction, 3-1 

CAncel command, 5-4 

Cassette file support handler, 
4-35 

Cassette file support system 
tasks, 4-35 

Cassette handler, 4-32 

Change of state UDC/ICS opera- 
tion, 4-30 

Character mode, 4-4 

Checkpointable tasks, 7-3 

Clock handler, 4-2 

Clock handler system parameters, 
6-10 

CTRL/C, 4-5, 5-1 

Communication region, 3-1 

Component sizes, B-1 

Control files, 
use of, 6-9 

Core image, 7-6, 7-7 

Creating an RTS/8 system, 6-5 

Creating SAVE image file, 6-6, 
7-6 



DAte command, 5-2 
Debugging, 

nonresident task, 7-8 
DECtape handler system parameters, 

6-14 
Demonstration program, 8-1 
DEposit command, 5-6 
DERAIL ER, 9-5 
Digital input UDC/ICS operation, 

4-27 



Digital output UDC/ICS operation, 

4-27 
Disable command, 5-4 
Disable contacts UDC/ICS operation, 

4-30 
Disable counter UDC/ICS operation, 

4-29 
Distributed source files, A-1 

Editing parameter file, 6-5, 6-8 

ENable command, 5-4 

Enable contacts UDC/ICS operation, 

4-29 
Enable counter UDC/ICS operation, 

4-28 
Error conditions, 

UDC/ICS, 4-31 
Event flag states summary, 2-3 
Event flags, 2-2 
Examine command, 5-6 
Executive internal task tables, 

2-5, E-1 
Executive KL8-A support, 4-37 
Executive request wait states, 

3-12 
Executive requests, 

BLKARG, 3-6 

DERAIL, 9-5 

POST, 3-4 

RECEIVE, 3-3 

RUN, 3-8 

SEND, 3-2 

SENDW, 3-3 

SKPINS, 3-9 

SUSPND, 3-8 

UNBARG, 3-8 

WAITE, 3-3 

WAITX, 9-5 
EXIT command, 5-6 
EXIT task, 4-39 
EXIT task system parameters, 6-14 

Field mapping, 4-20 

FINISHED state, 2-2 

Floppy disk control file, 6-10 

Floppy disk handler, 4-13 

Flowcharts, C-1 

FREE command, 7-4 

Generic code UDC/ICS operation, 
4-27 

Inhibiting task switching, 9-2 
Instructions, 

CAL, 3-1 

POSTDS, 3-10 
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WAITM, 9-4 
Interrupt module restrictions, 

3-10 
Interrupt skip chain, 3-9 
Intertask messages, 2-3 

KL8-A support system parameters, 
6-13 
OS/8 support task, 4-38 
TTY task, 4-38 
User task, 4-39 

LINCtape handler, 4-16 

Line mode, 4-4 

Line printer handler, 4-10 

Line printer system parameters , 

6-14 
Loading, 

nonresident tasks, 7-8 
Loading tasks, 6-6, 8-11 

Mass storage handlers, 4-11 
MCR command arguments, 

address, 5-1 

comma, 5-1 

single space, 5-1 

task-ID, 5-1 

time-of-day, 5-1 

word, 5-1 
MCR commands , 

CAncel, 5-4 

DAte, 5-2 

DEposit address, 5-6 

Disable, 5-4 

ENable, 5-4 

Examine address, 5-6 

EXIT, 5-6 

NAme, 5-2 

OPen address, 5-5 

POst address, 5-6 

REquest, 5-3 

STop, 5-4 

SYstat, 5-4 

Time, 5-2 
MCR component size, B-5 
MCR error messages, 5-6 
MCR system parameters, 6-12 
Memory partitions, 7-3 
Message header, 2-3 
Message table, E-3 

NAme command, 5-2 
Nonresident MCR, 5-6 
Nonresident task debugging, 7-8 
Nonresident task implementation, 

7-8 
Nonresident task initialization, 

7-5 



Nonresident task parameters, 7-5 
Nonresident tasks, 7-1 
Nonresident tasks, 

assembly, 7-8 

batch control, 7-8 

loading, 7-8 

SAVE image file, 7-8 

starting, 7-8 

Obtaining listings, 6-5 
OPen comraand, 5-5 
OS/8 file support task, 4-23 
OS/8 operating system, 4-19 
OS/8 support task, 4-19 
OS/8 support task system param- 
eters, 6-13 
OS/8-RTS/8 communication, 4-21 

Parameter file, 

task definitions, 6-2 

task setup, 6-4 

task specifications, 6-3 
Parameter file structure, 6-1 
Partition parameter initializa- 
tion, 7-7 
Partition table, E-4 
PDP-8A null task, 4-37 
PENDING state, 2-2 
Performing a reschedule, 9-1 
POst address command, 5-6 
POST ER, 3-4 

POSTDS instruction, 3-10 
Power fail task, 4-18 



Read counter UDC/ICS operation, 

4-29 
Real-time system operation, 1-2 
RECEIVE ER, 3-3 
REquest command, 5-3 
Residency table, E-3 
RTS/8 description, 1-1 
RTS/8 task structure, 2-1 
RUBOUT, 4-4 
RUN ER, 3-8 

Sample task program, 6-7 

SAVE image file, 
creating, 6-6, 7-6 
nonresident tasks, 7-8 

Saving the system, 6-6, 8-11 

SEND ER, 3-2 

SENDW ER, 3-3 

SKPINS ER, 3-9 

Starting, 

nonresident tasks, 7-8 

STop command, 5-4 

SUSPND ER, 3-8 

Swap device, 7-1, 7-6 
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Swapper system parameters, 6-11 
Syntactic constructions, 5-1 
SYstat command, 5-4 
System parameters, 

clock handler, 6-10 

DECtape handler, 6-14 

EXIT task, 6-14 

KL8-A support, 6-13 

line printer, 6-14 

MCR, 6-12 

OS/8 support task, 6-13 

swapper, 6-11 

terminal handler, 6-11 
System status report code, 5-5 
System tables direct references, 

9-8 
System task summary, 4-1 
System tasks, 

cassette file support, 4-35 

cassette handler, 4-32 

clock handler, 4-2 

EXIT, 4-39 

floppy disk handler, 4-13 

LINCtape handler, 4-16 

Line printer handler, 4-10 

mass storage handler, 4-11 

OS/8 file support, 4-23 

OS/8 support, 4-18 

PDP-8A null, 4-37 

power fail, 4-18 

terminal handler, 4-2 

UDC/ICS handler, 4-24 

Task communication, 2-1 
Task flags table, E-2 
Task number, 2-1 
Task state table, E-1 
Task status report, 5-5 
Task synchronization, 2-2 



Terminal handler, 4-4 

Terminal handler system param- 
eters, 6-11 

Terminal parameter default values, 
4-9 

Time command, 5-2 

Timeshare function disabled, 4-19 

TTY control file, 6-9 

TTY task KL8-A support, 4-38 

UDC/ICS assembly parameters, 4-31 
UDC/ICS error conditions, 4-31 
UDC/ICS handler, 4-24 
UDC/ICS handler system tasks, 4-24 
UDC/ICS operation, 

analog input, 4-26 

analog output, 4-25 

change of state, 4-30 

digital input, 4-27 

digital output, 4-27 

disable contacts, 4-3 

disable counter, 4-29 

enable contacts, 4-29 

enable counter, 4-28 

generic code, 4-27 

read counter, 4-29 
UNBARG ER, 3-8 
Use of control files, 6-9 
User task KL8-A support, 4-39 
Using BITMAP program, 6-7, 7-5 
Using interrupts, 3-9 

WAITBITS symbolic names, 3-7 
WAITE ER, 3-3 
WAITING state, 2-2 
WAITM instruction, 9-4 
WAITX ER, 9-5 
Writeable tasks, 7-3 
Writing delicate code, 9-1 
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READER'S COMMENTS 



NOTE: This form is for document comments only. DIGITAL will 
use comments submitted on this form at the company's 
discretion. Problems with software should be reported 
on a Software Performance Report (SPR) form. If you 
require a written reply and are eligible to receive 
one under SPR service, submit your comments on an SPR 
form. 

Did you find errors in this manual? If so, specify by page. 



Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 
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Is there sufficient docximentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 



Please indicate the type of user /reader that you most nearly represent. 

I I Assembly language programmer 

I I Higher- level language programmer 

I I Occasional programmer (experienced) 

n User with little programming experience 

I I Student programmer 

(~1 Non-programmer interested in computer concepts and capabilities 

Name . Date 

Organization _^^_____ 

Street . 



City State zip Code. 

or 
Country 
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RTS/8 SYSTEM TASKS 



RW 



PAGES 



Read data from floppy disk. 
4000 Write data to floppy disk. 

Specifies the number of pages to transfer (times 
100 octal). Pages = transfers 40 pages (a full 
field) . This value takes the range 0-37 in bits 
1-5 of this word. PAGES is ignored if CODE = 
4000. In that case, either 100 (octal) 12-bit 
words or 200 8-bit bytes (from 200 words) are 
transferred depending on MODE. 



FIELD 



BUFADD = 



BLOKNO = 



STATUS 



Specifies the field of buffer (times 10 
Bits 6-8 of this word have the range 0-7. 



octal) . 



Specifies the address of the first word of the 

buffer containing data. Field of buffer is 

determined by FIELD. Length of buffer depends on 

PAGES if CODE = or on MODE if CODE = 4000. 

Represents first logical OS/8 block to transfer if 
CODE = 0. Each OS/8 block consists of 4 sectors. 
Track is ignored and a 2-to-l interleave scheme 
is employed. If CODE = 4000, this word contains 
physical track and sector numbers in the format 
TTTTTTTSSSSS. 

Receives the status of the operation upon 
completion. If negative, a hard error has 
occurred. If 0, no error has occurred. This word 
may be positive nonzero only if DEL = 2000. 



The meaning of the STATUS bits is as folio 



ws : 



Bit 



1-3 

4 

5 

6-7 

8 



10 
11 



Meaning if 1 

Hard error 

Not used by controller 

Not used by RTS/8 

Deleted data indication 

Not used by controller 

Reserved for future use by 

controller 

INIT done (can occur after 

temporary power failure to 

controller) 

Parity error 

CRC error 



NOTE 

On power fail restart, the INIT error 
might occur. When this error occurs, 
the calling task should send the I/O 
message again. 
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